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ABSTRACT 

Selected pages from the nine research editions of the UNIX* Programmer's 
Manual illustrate the development of the system. Accompanying commentary 
recounts some of the needs, events, and individual contributions that shaped this 
evolution. 


1. Introduction 

Since it began at the Computing Science Research Center of AT&T Bell Laboratories in 
1969, the UNIX system has exploded in coverage, in geographic distribution and, alas, in bulk. It 
.has brought great honor to the primary contributors, Ken Thompson and Dennis Ritchie, and has 
reflected respect upon many others who have built on their foundation. The story of how the system 
came to be and how it grew and prospered has been told many times, often embroidered almost into 
myth. Still, aficionados seem never to tire of hearing about how things were in that special circle 
where the system first flourished. 

This collection of excerpts from the nine editions of the research UNIX Programmer 's Manual 
has been chosen to illustrate trends and some of the lively give-and-take— or at least the tangible 
results thereof— that shaped the system. It is a domestic study, aimed only at capturing the way 
things were in the system’s original home. To look further afield would require a tome, not a report, 
and possibly a more dispassionate scholar, not an intimate participant. The raw readings are supple- 
mented by my own recollections as corrected by the memories of colleagues. 

The collection emphasizes development up to the Seventh Edition (v7 a ) in 1979, providing 
only occasional peeks ahead to vg and v9. Although people elsewhere in Bell Labs and in Berkeley 
made significant contributions before v7, it was really with v7 that the system fledged and left the 
research nest. V7 was the first portable edition, the last common ancestor of a radiative explosion to 
countless varieties of hardware. Thus t!:e history of v7 is part of the common heritage of all UNIX 
systems, while v8 and v9 will be more or less foreign to many readers. Moreover v7 happened long 
enough ago to be viewed with reasonable perspective. 

The system was already well developed before vl appeared in 1971. And not until v4 was the 
system first described in public [12], [131. The technical side of the development from a paper exer- 
cise through a fully self-supporting model on a DEC PDP-7 to implementation on a series of PDP- 
11s has best been told by Ritchie in 111]. In his Turing Award lecture Ritchie reflected further 
upon the nature of the lab environment that fostered the development [10], 

To keep the size of this report in bounds current versions of manual pages are rarely shown; 

\ 

* For brevity i have adopted the designation vit for the nth Edition. This usage sprang from a colloquial tendency 
to refer to the Sixth and Seventh Editions as Versions 6 and 7, which inevitably led to the nickname v8 for the 
Eighth Edition. The rest followed. 



interested readers will be familiar with and doubtless own the manual for v7 or one of its many des- 
cendants, such as System V or BSD. Many of the pages were chosen to show things happening, and 
some to show foibles. Enduring central features have been correspondingly slighted. By overlooking 
the news (or nonnews) about permanent things, I have unfortunately also overlooked the news (or 
nonnews) about just how well Thompson and Ritchie wrought. As many people have observed, the 
success of the UNIX system often owes as much to what it does not have as what it does. In the 
same way. lasting truths are likely not to be found in this story about its changes. Those I have 
tried to tell elsewhere [7j. 

In condensing the flow of events into comprehensible and compact history, I have largely over- 
looked, if indeed I could even have recognized, the myriad of borrowings of style and viewpoint and 
the continual interplay of criticism and code-dabbling that knit a cohesive gestalt. Without the 
vision of Ken Thompson, UNIX would not have come into existence; without the insight of Dennis 
Ritchie, it would not have evolved into a polished presence; without the imagination of Mike Lesk 
and popularizing touch of Brian Kernighan, it would not have acquired the extroverted personality 
that commands such widespread loyalty. But without any one of the people whose contributions are 
cited here, neither UNIX nor the work of others in the group would be the same. 

1.1. The People 

Up to v7 the dramatis personae were relatively few. Never officially recognized in any organ- 
ization chart, the group coalesced voluntarily. Most of these original contributors are still with the 
Computing Science Research Center or its divestiture-induced clone at Bell Communications 
Research. 

Ken Thompson began the construction from the ground up based on a file system model 
worked out with Ritchie and Rudd H. Canaday. He made processors for B, has. and Fortran 
- besides the operating system proper, and personally insulted customized versions of UNIX for early 
clients as far away as Georgia. With Ritchie, Ken wrote the first shell and piles of utilities includ- 
ing ed. roff, sort, grep, uniq, plot, sa, and dd. He is also known for creative decompiling of mystery 
code. As if all this weren’t enough, he has at the same time written circuit-optimizing tools, switch- 
ing and network code, C compilers, and the basic software for several special-purpose machines, 
especially the chess champion. Belle. 

Dennis Af. Ritchie, best known as the father of C, joined Ken very early on. Dennis contri- 
buted basic notions such as fork-exec and set-userid programs. They jointly wrote the fc compiler 
for Fortran IV. The first debugger db and the definitive ed were Ritchie’s, as was the radically new 
stream basis for 10 in v8 and much networking software. With Steve Johnson he made UNIX port- 
able. moving the system to an Interdau machine (v7). The names of Ritchie and Thompson may 
safely be assumed to be attached to almost everything not otherwise attributed. 

Joe (Joseph F.) Ossanna, with the instincts of a motor pool sergeant, equipped our first lab 
and attracted the first outside users. Joe’s nroff and troff indelibly shaped UNIX word processing 
and typesetting. 

Bob ( Robert ) Morris stepped in wherever mathematics was involved, whether it was numerical 
analysis or number theory. Bob invented the distinctively original utilities typo, and dc-bc (with 
Lorinda Cherry), wrote most of the math library, and wrote primes and factor (with Thompson) 
His series of crypt programs fostered the Center’s continuing interest in cryptography. 

Doug (M. Douglas) Mcllroy exercised the right of a department head to muscle in on the ori- 
ginal two-user PDP-7 system. Later he contributed an eclectic bag of utilities: tmg for compiler 
writing, speak for reading text aloud, diff, and join. He also collected dictionaries and made tools to 
use them: look (v7, after a model by Ossanna), diet (v8), and spell (v7). 

Lorinda L. Cherry collhborated with Morris on dc-bc and typo. Always fascinated by text 
processing, Lorinda initiated eqn and invented parts, an approximate parser that was exploited in 
the celebrated Writer’s Workbench*, ww-bCvS). 

Steve ( Stephen C.) Johnson's yacc reduced Al (Alfred V.) Aho's expertise in language theory 
to practice. Upon that base Steve built the portable C compiler that was used to port the system 



itself and to evaluate candidate instruction sets for unbuilt machines. Johnson made, the first spell. 
worked on computer algebra, and devised languages for VLSI layout. 

Lee E. McMahon's linguistic insight fostered the characteristic text-processing— as distinct 
from text-formatting— capabilities of the system. He wrote comm, qsort. sed. the current grep. and 
the concordance-builders index for English and ere f for C. After an early fling with cu and an 
influential laboratory switching system done with Condon, Morris, Thompson, Chuck (Charles B.) 
Haley and Cherry, Lee became the prime software architect for Sandy Fraser’s Datalut* switch. 

Brian W. Kernighan, expositor par excellence, coined the name UNIX, popularized the tools 
philosophy [6], wrote the best tutorials, and became a prolific inventor of specialized “little 
languages”: ratfor, eqn, awk and pic. The Center’s typesetting guru since the untimely death of Joe 
Ossanna, Brian produced the current “device-independent” version of troff and postprocessors for 
particular hardware. 

Sieve (Stephen R.) Bourne arrived at the time of v6, bringing Algol 68 with him. His defini- 
tive programs, the debugger adb. and the “Bourne shell,” although written in C, looked like Algol 
68: Steve wrote 00-00 and BEGIN- END instead of { and >. Bourne also contributed macro con- 
structs to the UNIX Circuit Design System (see 4.3). 

Mike (Michael EJ Lesk, with a prescient market instinct, made text formatting accessible to 
the masses with the generic macros —ms. which were to troff what a compiler is to assembly 
language. He rounded out — ms with the preprocessors tbl for typesetting tables and refer for 
bibliographies. He also made the lex generator of lexical analyzers. Eager to distribute his 
software quickly and painlessly, Mike invented uuep. thereby begetting a whole global network. 
Over the years, often helped by Ruby Jane Elliott, he initiated fascinating on-line audio, textual, 
and graphical access to phone books, news wire (apnews, v8), weather (v8), and UNIX instruction 
(.learn, with Kernighan, v7). 

Stu (Stuart l.) Feldman implemented, with Andy (Andrew DJ Hall, the efl preprocessor to 
sugar Fortran with PL/I-ish syntax. He wrote the f77 Fortran compiler single-handedly and 
invented the famous make. A man of taste and culture, Stu exhibited both in his underground clas- 
sic on UNIX style [3l. 

Peter J. Weinberger has moved effortlessly among number theory, databases, languages, and 
networking. Weinberger boasts the middle initial of awk, the IO library for /77. and a famous 
visage (see FACED, page 14). In v8 and v9 appeared an unbounded precision arithmetic package 
mp, a fast factoring program qfactor, a B-tree library cbt, and a new code generator for C, all 
Peter’s work. Above all, his network file system bound a stable of machines together into a logically 
homogeneous system (v8). 

Sandy (A. G.J Fraser devised the Spider local-area ring (v6) and the Datakit switch (v7) that 
have served in the lab for over a decade. Special services on Spider included a central network file 
store, nfs, and a communication package, ufs. Datakit, a “central office” for data communication, 
gave added impetus to research in distributed computing. Fraser undertook the Unix Circuit Design 
System (see CDL in section 4.3) to support his hardware projects. 

Joe (Joseph HJ Condon, physicist and circuit designer extraordinaire, although not usually 
listed as an “author” of UNIX, is an indispensable presence among the group. He wrote much of 
the Unix Circuit Design System, including sophisticated wire-routing algorithms. He designed 
superfast specialized machines, including the chess machine Belle (with Thompson), domesticated 
real telephone switches to our laboratory environment for the experiments of McMahon and others, 
and made unusual connections to the telephone system that, among other things, let our lab com- 
puter detect and announce incoming voice calls. 

Al (Alfred V.) Aho's unstintingly given insight into language theory and algorithms shows up 
in programs by many people^ such as yacc, lex, cc, the Writer’s Workbench, and the screen editor 
sam, as well as in his own awk, egrep, and fgrep. 

Greg (Gregory L.) Chesson pursued all aspects of computer-to-computer communication: mul- 
tiplexing with mpx (v7), flow-controlled channels with con (v7) and dcon, and protocols, including 
one used by uuep. The first kernel- and user-level software for Datakit was his. 



• 4 - 


Many other people contributed. By the time of v4 the role of provider to the by then sizable 
clientele within Bell Labs had been assumed by Berk (Berkley Aj Tague and his UNIX Support 
Group, thereby guaranteeing the future of the system. Shortly thereafter the Programmer’s Work- 
bench project undertook to adapt the system to support large software efforts. Their concern with 
administrative tools led to somewhat differently flavored utilities such as find (v5), cpio (v7), and 
secs. Joe (Joseph FJ Moranxano of the USG and Dick (Richard CJ Haight of PWB became de 
facto adjunct members of the research group. Haight contributed find, cpio, and expr, all in v7. 
Ted (Theodore A.) Dolotta of PWB did much to refine the manual. 

Some USG and Computer Center people eventually joined the Computing Science Research 
Center to bring order to our zoo of equipment: Andy (Andrew RJ Koenig conceived and built asd, 
the automatic software distribution system that keeps v9 current across about 50 different comput- 
ers, and snocone, a preprocessor to sugar the syntax of Snobol into a structured language. Fred 
(Frederick T.) Grampp's unrivaled practical experience in computer security shows up in subtle 
countermeasures now routinely used in our systems. A thorough security audit program of his ulti- 
mately became the administators’ tool quest. Ed (Edward J.) Sitar, with devotion worthy of 
Ossanna, saw to it that the hardware actually worked, keeping twenty machines housed and 
powered, and suppliers on their mettle. 

Tom (Thomas B.) London and John F. Reiser ported v7 to the VAX and introduced paging. 
Their V32 system, as filtered through Berkeley, became the progenitor of almost all research UNIX 
systems. Reiser later contributed a peerless compile-and-execute bitblt for the Teletype 5620. 

People who joined the research center after v7 led development in new directions. Bart N. 
Locanthi designed the bitmapped terminal known variously as “jerq," “Blit,” and Teletype 5620. 
He programmed it. too: from graphic primitives, such as the crucial bitblt. up to a multiterminal 
maze war game. Rob Pike supplied a multiprogramming system, host-terminal communications, 
mouse control, and support for overlapping virtual terminals ( mpx , later mux). Pike’s system fos- 
tered fascinating programs by many people, of whom I shall mention only a few (vg). Pike himself 
built visual editors, culminating with sam (v9), which went well beyond the command capability of 
vi —seemingly with no more mechanism than the venerable ed. (Rob’s simplifying touch is also visi- 
ble in the shell, in p for paginating, and in his recasting of Chesson’s remote execution software, all 
in v8.) 

The Blit terminal attracted Mark S. Manasse who (with Pike) invented lens, an algorithmi- 
cally ingenious bitmap magnifier, and tek40l4, a disarmingly faithful simulator of Tektronix termi- 
nals. Luca Cardelli contributed an icon builder, annoying crabs that devour screen images, and the 
catchy vismon that posts icons of the senders of incoming mail. Tom (Thomas A.) Cargill did a 
monumental multiview debugger pi. thoroughly exercising the object-oriented capabilities of Bjarne 
S t roust rup’s C++. Tom (Thomas JJ Killian made a font editor jf and programs to save and print 
bitmap images ( blitblt . thinkblt ) that led in turn to can, a comprehensive suite of laser-printer 
software built from the ROM up. For the UNIX system itself, Killian invented the important 
/proc file system that contains core images of all running processes. 

Dave (David D Presotto tamed networks. His upas brought some order to a Babel of mail 
addresses and his ipc primitives provided a common basis for communication and remote file access 
via Internet, Ethernet, and Datakit. Bill (William T.) Marshall, who shares principal Datakit 
software responsibility with McMahon, wrote basic protocol code. These protocols merit unusual 
confidence: their correctness was mechanically verified by Gerard Holzmann. 

Andrew G. Hume wrote proof to put troff on your screen (v8, begun by Locanthi), parts of 
the UNIX Circuit Design System (v9), mk to supplant make (v9), and a remote backup service 
(v9). Norman Wilson shares with Ritchie the honors of reigning guru. He has been instrumental 
in porting v8 to a Cray and in rationalizing system configuration procedures. Waging a personal 
battle against entropy, Wilsoh rectified countless infelicities, glitches, and blunders in the software 
and the manual, always making things shorter and simpler as he did so. 
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1.2. The Manual 

During the system’s first two years one literally had to work beside the originators to learn it. 
But the stock of necessary facts was growing and the gurus’ capacity to handle apprentices was lim- 
ited. As they wished to spread the good news about their marvelous system, a manual became a 
necessity. Ritchie one day set forth the first “man page" in a format that has stood the test of time. 
The terse, yet informal, prose style and alphabetic ordering encouraged accurate on-line documenta- 
tion: it was not a big deal to decide how and where to describe changes as they happened. The for- 
mat was popular with initiates who needed to look up facts, albeit sometimes frustrating for 
beginners who didn’t know what facts to look for. 

The absence of any “logical” grouping of facilities was a deliberate result of discussion. (As 
encyclopedists have always known, the relationships among knowledge are too various to force into 
rational linear order.) Retrievability and honesty were the prime concerns. The refreshing BUGS 
notes served as a constant reminder of areas for improvement. 

The first manual was duplicated for a very small coterie. In order to channel queries directly 
to the horses' mouths, authorship was attributed to individuals. Later, as authorship diffused, on the 
principle of “You touched it last; it’s yours,” authorship was attributed only in the segregated 
chapter of unofficial “user maintained programs.” Beginning with v7, this back-of-the-bus chapter 
was reserved for games. 

As the system was elaborated, peer pressure in the research group caused rough places to be 
smoothed, vague ideas to be sharpened, and feeble programs to be extinguished. Most details of the 
constant questioning and experimentation during the early period of rapid change are long forgotten, 
as are hundreds of transitory states that were recorded in the on-line manual. From time to time, 
however, a snapshot was taken in the form of a new printed edition. Quite contrary to commercial 
practice, where a release is supposed to mark a stable, shaken-down state of affairs, the very act of 
preparing a new edition often caused a flurry of improvements simply to forestall embarrassing 
admissions of imperfection. 

1.3. The Events 

Among the more memorable minirevolutions that the system experienced were 

— The appearance of pipes elevated standard-in-standard-out design to the status of a “philoso- 
phy" (v3). Old software was gradually brought into line (see SORT on page 7). 

— Grep (Thompson, v4) ingrained the tools outlook irrevocably. Already visible in utilities such 
as wc (Ossanna, vl), cat, and uniq (v3), the stream-transformation model was deliberately 
followed in the design of later programs such as tr (Mcllroy, v4), m4 (Kemighan and Ritchie, 
v7), sed (McMahon, v7), and a flurry of language preprocessors. 

— Conversion to C (v4) made basic abstractions clearer. Assembly language and magic con- 
stants gradually declined from the status of the “real truth” (v4) to utterly forgotten (v8) . 

— The novel style of eqn influenced the design— even the conception— of a still growing genera- 
tion of special purpose languages (v5). 

— The move away from PDP-1 Is caused a further push for portable abstractions. The main visi- 
ble symptom was a proliferation of include files (v7). 

— The Bourne shell almost overnight drove out the simple old shell. A PWB shell had made 
shell programming useful; the Bourne shell made it an essential part of UNIX programming 

(v7). 

— Mike Lesk’s uucp gave operational meaning to the phrase “UNIX community” (v7). News 
now travels electronically among users all over the world; and technical collaborations proceed 
between distant location almost as easily as within one building. 

— Direct network connections among our computers began with Sandy Fraser’s Spider network 
and became widespread with Datakit (Chesson and Ritchie, v7). Datakit and Ritchie's 
streams (v8) made possible Peter Weinberger’s network file system, Andy Koenig’s automatic 
software distribution, and Dave Presotto’s connections to diverse networks. As a result “the” 
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research machine is no longer identifiable; users can— and do— work on one or more of two 
dozen computers simultaneously. 

— Bitmapped terminals operating under Rob Pike’s “jerq” software caused a quantum jump in 
personal multiprogramming and inspired intriguing new programming styles (v8). 

The early editions came in quick succession. Later the interval between editions increased for 
several reasons. First, most of the system was mature and stable. Second, from the standpoint of 
the manual, much research was subliminal. For example, the biggest system changes from v6 to v7 
to v8— portability and streams -barely affected the manual. Third, the need for timely printing 
diminished as other organizations became responsible for distribution. And fourth, as the system 
grew to encompass facilities beyond any individual’s ken,* the task of organizing an ever-growing 
manual for printing became increasingly daunting. 

The UNIX lab has always been an exciting place to work. As I recorded this summary, I 
recalled vivid individual moments when new ideas or startling combinations of old ideas flashed 
through the lab, when programming met theory and vice versa, and when advances on many simul- 
taneous fronts built upon and reinforced one another. I was forcibly reminded over just how wide a 
spectrum of activities and interests each member of the group has ranged and how freely and 
without fanfare collegial help has flowed among them. The primary dividends to the participants 
have been the fun of doing, the joy of accomplishment and the satisfaction of seeing one’s handiwork 
used. Intellectual proprietorship and physical ownership count for little; there’s more than enough 
of both for everyone. 


2. Primary Commands 
CAT (vl page lit) 

Cat is probably the oldest and best-known of all distinctively UNIX utilities. The current (v9) 
description scarcely differs from that in vl. On the PDP-7 there had been a program pr for copying 
a single file to the terminal. Having been subsumed by cat, pr was retired and its name was recy- 
cled. 

Since cat was the prototypical filter, people were tempted to pile on options for other func- 
tions. Thus cat was pressed into service to block output into SI 2-byte chunks. That in turn led to 
cat -u (v7) to turn the feature off. This dismal admission that byte streams might not always be 
pure had been overcome by the time of v8. In other circles the chastity of cat was violated more 
severely; see Pike’s essay on cat -v{9] . 

CP (vl page 17, v5 page It) 

The war-horse utility cp and its close relative mv originally worked on lists of pairs. Such 
lists, however, could not be generated by the shell’s * convention. All too often mistyped lists clob- 
bered precious files. Consequently both utilities were promptly cut back to handle just one from-to 
pair (v2). At the same time mv was generalized to move flies to a named directory. Strangely cp 
picked up only a BUG note suggesting the feature. By the time of v3 both had converged to their 
present forms, although an unexplained option -t intruded briefly in v5. What seems natural in 
hindsight was not clear cut at the time: the final conventions arose only after long discussions about 
how properly to handle file permissions and multiple files. In fact the discussion is not yet closed. 
Whether and how to recurse on directories is still debated: v7, v8, and v9 each offered a different 
way to do it. 


* Ken’s Icen *u probably the last to saturate. At the time of vj, shell accounting once revealed that Thompson 
had used 102 distinctly named programs in the course of a week. Nobody else came close, 
t The cat page from v| is reproduced on page 16 of this report. 



SORT (vl page 19, vS page 20) 

This mainstay utility began as a “user-supported progam” in chapter 6 of vl (Thompson). 
Upon query to the author it turned out that the “wide options” announced there involved altering 
the source. The first official options appeared in v4. Expanding ever since, the load of options 
reached 17 in v9 (Mcllroy and John P. Underman of the Computer Technology Research Lab). 
The program originally sorted in core; pressure of real use soon forced it to spill to disk. 

The first design, typical of pre-pipe days, had an argument to name the output (see GREP 
below); 

sort input output 

During the pipeline revolution Thompson modified sort to be usable as a filter (v4). Unlike most 
utilities, though, sort did retain an output-naming convention because it was so often used to sort a 
file in place, which couldn't be done with >. 

When he extended sort to handle multiple files, Thompson invented a special name for 
the standard input (vS). The convention caught on and soon infected many other commands. As a 
property of particular commands and not of the system as a whole, “-” itched naggingly. The itch 
went unscratched until Ritchie, at Pike’s suggestion, installed fd special files synonymous with 
already open file descriptors (v8). The stubborn disease remains, however. 

A bug note in join(l) declares, “The [field-specification] conventions of join. sort. comm, 
uniq, look and awfc(l) are wildly incongruous.” Although these programs are often used together, 
they remain, like American weights and measures, sturdily eccentric. 

MAIL (vl page 21, v7 page 22) 

Electronic mail was there from the start. Never satisfied with its exact behavior, everybody 
touched it at one time or another; to assure the safety of simultaneous access, to improve privacy, to 
survive crashes, to exploit uucp, to screen out foreign freeloaders, or whatever. Not until v7 did the 
interface change (Thompson). Later, as mail became global in its reach, Dave Presotto took charge 
and brought order to communications with a grab-bag of external networks (v8). 

Despite the turbulent evolution of mail, to this day a simple postmark is all that it adds to 
what you write. Old UNIX hands groan at the monstrous headers that come from latter-day mailers 
and at the fatness of their manuals. 

ECHO (v2 page 23) 

Echo, seemingly the simplest of utilities, originated with Multics, where it was used to test the 
sanity of the shell. The present version arose as a finger exercise in C programming (Mcllroy, v2). 
Then it turned out to be useful, a mainstay of shell scripts. 

For a while echo was complemented by prompt (never documented), which did the same thing 
without a newline. Eventually prompt was displaced by echo -n (Ritchie, v7). Meanwhile a 
minor echo-amplification industry arose in some quarters. Imported versions of echo with elaborate 
syntax came and went in a midnight vendetta; for a time it was the least stable of all commands. 
Ritchie calmed the altercation with a Solomonic but un-UNIX-Iike option to switch between two 
competing syntaxes (v8). Not surprisingly, the more elaborate choice has never been needed in any 
shell script in /bin or /uar/bin. The whole episode inspired Mcllroy’s parable, “The Unix and 
the Echo,” quoted in [5], page 79. 

GREP (v4 page 24) 

Grep. generally cited as the prototypical software tool, was born when Ken Thompson was 
asked how to search for patterns in a file that was too big for the editor. Thompson promptly 
liberated his regular expression recognizer and christened it after the ed command g/re/p. It was 
an instant hit and soon entered our language as a verb. 

The success of grep suggested other utilities. One of these, gres for global substitution, 
evolved into the stream editor sed (McMahon, v7). Grep also inspired A1 Aho to apply his 
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encyclopedic knowledge of language theory to make the very general egrep and the highly special- 
ized fgrep (v7). Over the years Aho honed egrep into an awesomely performing program, simple on 
the outside but the highest of tech on the inside. 

The v4 manual page for grep is typical of earlier editions. Options were described in running 
text along with the basic usage; the more readable convention of always displaying options 
separately, no matter how few a command might have, gained ground only slowly. In typical early 
style the synopsis permits an output argument as well as an input argument— poor human engineer- 
ing, because of the disastrous consequences of invoking command input output as if were com- 
mand input 1 input2. This dangerous syntax was expunged from most commands by v7, but at 
least one fossilized instance survives in BSD 4.3. 

3. Programming 

3.1. The Shell 

SH (v 1 pages 25-27, v3 pages 28-33, »4 pages 34-36) 

The name and the general outline of the “shell" originated in Multics, but for UNIX the shell 
had to be pared back to basics to fit in an 8K user space. There wasn’t even enough room to do • 
name expansion; that task was handed off to another program glob, signifying “global” (Ritchie, 
vl). (Glob, written in B, was the first piece of mainline UNIX software to be done in a higher level 
language.) ' i /. L •„ 

The shell read commands from the same standard input as did programs that it invoked. Thus 
commands and data were interleaved in command files, or “runcoms,”* now usually called shell 
scripts. There was no way to mark the end of embedded data flies; programs that buffered their 
input would consume input not intended for them. Consequently programs that were likely to read 
from shell scripts, especially jrA and ed, were made to read their input one character at a time. It 
was impossible to pipe into a shell script because the standard input was already dedicated to the 
script. For the same reason a program in a shell script could not take input from a terminal except 
when given the terminal’s real name. None of these problems was addressed until the Bourne shell 
solved them all at once (v7). 

A shell notation for composing programs into pipelines accompanied Mcllroy's proposal for 
pipes. This new idea, with its curious syntax, took almost a page to describe (v3). The syntax was 
reformed when, to avoid the embarrassment of describing it in a big public talk, Thompson proposed 
the appealing infix ! . Thus naturalized, pipelines became describable in just four sentences in v4 

The UNIX shell gave up the Multics idea of a search path and looked for program names that 
weren’t file names in just one place, /bin. Then in v3 /bin overflowed the small (236K). fast 
fixed-head drive. Thus was /uar/bin born, and the idea of a search path reinstated. 

GOTO, : (v2 pages 37-38) 

Goto manipulated the standard input to give the illusion of a programmable shell (Thompson, 
v2). The associated ; command, which thanks to ASCII collating sequence boasted the first page in 
the manual, was a big nop. 

Other flow-of-control programs were if. to execute a command conditionally (Ritchie and 
Thompson, v2), and exit (Thompson v2). With the luxury of bigger computers. Bourne made a 
genuinely programmable shell and abolished these clever but clumsy tricks (v7). Nevertheless . sur- 
vives as a built-in shell command and test has inherited the boolean capabilities of if. 


• Runcorn, a program that could run a short script of commands in the background, was the closest thing MIT’s 
CTSS had to a callable shell. A vestige of the name survives in the boot script, /etc/rc. 



3.2. System Calb 


ST AT (vl page 39, v4 page 40, v7 pages 41<42) 

Slat is one of very few original system calls to have changed at all, mostly because through it 
user code glimpses system tables. In v4 group permissions appeared and file sizes went from 16 to 
24 bits. The size change was tough; it meant rebuilding every existing file system, and the longer 
addresses compelled some trickery to avoid sacrificing space or performance on smaller files. 

The snapshots of stat also show how the style of description evolved from assembly language 
(vl) through C (v4) to a more abstract and portable form with declarations hidden in include files 
(v7). The traditional sense of what constituted the real system interface eroded very slowly. Even 
though almost all programs were written in C, assembly language held pride of place in the manual 
through v6. Banished to a footnote in v7, assembly language did not disappear completely until vg. 
twelve yean after the birth of C. 

PIPE (v3 page 43) 

The basic redirectability of input-output made it easy to put pipes in when Doug Mcllroy 
finally penuaded Ken Thompson to do it. In one feverish night Ken wrote and installed the pipe 
system call, added pipes to the shell, and modified several utilities, such as pr and ov (see S.l 
below), to be usable as filten. The next day saw an unforgettable orgy of one-linen as everybody 
joined in the excitement of plumbing. Pipes ultimately affected our outlook on program design Jar' 
more profoundly than had the original idea of redirectable standard input and output. 

All programs placed diagnostics on the standard output. This had always caused trouble when 
the output was redirected into a file, but became intolerable when the output was sent to an 
unsuspecting process. Nevertheless, unwilling to violate the simplicity of the standard-input- 
standard-output model, people tolerated this state of affairs through v6. Shortly thereafter Dennis 
Ritchie cut the Gordian knot by introducing the standard error file. That was not quite enough. 
With pipelines diagnostics could come from any of several programs running simultaneously. Diag- 
nostics needed to identify themselves. Thus began a never quite finished pacification campaign: a 
few recalcitrant diagnostics still remain anonymous or appear on the standard output. 

The first implementation of pipes used a single file descriptor for both reading and writing 
(v3). The modern scheme, with two file descriptors, came in the next edition. 

INTR (vl page 44), SIGNAL (v4 page 45) 

In vl there was a separate system call to catch each of interrupt, quit, and two kinds of 
machine traps. Floating point hardware (v3) brought another and no end was in sight To stop the 
proliferation, all traps were subsumed under a single system call, signal (v4). The various traps 
were given numb era, by which they were known until symbolic names were assigned in v7. We have 
not been fully weaned yet: the numbers are still needed in the shell trap command. 

A simple unconditional kill was available to terminate rogue programs in the background 
(v2). In vS kill was generalized to send arbitrary signals. Never, however, was the basically 
unstructured signal-kill mechanism regarded as a significant means of interprocess communication. 
The research systems therefore declined to adopt the more reliable, but also more complex, Berkeley 
signals. 

In general, research UNIX systems, out of a belief that asynchrony is nasty, have provided less 
overt support for it than have some of their relatives. Thus when multiprocess coordination is una- 
voidable, as for receiving mail, curious synchronizing tricks with dummy files have been resorted to. 
The short-lived multiplexor (Cbesaon, v7), then Ritchie’s /dev/pt named pipes and select 
(adapted from Berkeley) lent, some support for these special needs (v8); Presotto’s ipc code goes still 
further (v9). 

The research systems remain standoffish about unbridled parallelism; the recent facilities for 
asynchrony are used only by cognoscenti. Nevertheless users of UNIX systems are probably more at 
home with parallel computing— as structured by pipes— than is almost any other user community. 
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STTY (t 2 pages 46-47), IOCTL (v7 page 48) 

Ioctl is a closet full of skeletons. The ioctl story began with stty (v2), the primary use of 
which— setting modes upon logging in— was unexceptionable. Trouble set in when other programs 
began to use it. These programs would work for their owners on their owners’ terminals, but could 
fail frustratingly in other settings. Thus was the slippery slope to curses first glimpsed. 

Stty accumulated features gradually, and often incompatibly. Eventually it was rechristened 
ioctl to keep abreast of plans for the corporate standard release 3.0 (v7). This faceless name, with 
no intrinsic meaning, quickly acquired more than enough. It was somehow exempt from the ethos of 
simplicity that kept the lid on new system calls. All kinds of functions were piled onto ioctl. The 
interface varied bewilderingly from function to function and from system to system. Documented 
willy-nilly throughout chapter 4 and sometimes only in source code, its true dimensions can never be 
appreciated. 

3.3. Standard 10 
PRINTF (t 4 page 49) 

Output formatting was originally left up to programmers (or to Fortan). Although vl 
included conversion routines like atof, the print/ routine that Ritchie had long since devised for 
BCPL did not arrive until the C change (v4). Formatted input was even slower in coming: Mike 
Lesk’s portable IO library that included scan/, as well as gets and ungetc, did not become official 
until v7. 

PUTC (vl page 50), STDIO <?7 page 51) 

Buffered IO was, and still is, a necessary evil. A rudimentary buffering package with getc 0 
and putc 0 in vl required the user to supply buffers and manage file descriptors. This scheme per- 
sisted until Ritchie’s stdio reconciled the buffering package with Lesk’s portable IO, hid the depen- 
dence on file descriptors, and eliminated per-character function calls. In one clean sweep stdio 
made C programs easily portable. In the ANSI draft standard for C stdio enjoys equal status with 
the language proper. 

3.4. Languages 

Almost everybody in the group has done languages. Thompson and Ritchie built assemblers 
from scratch. On the tiny PDP-7 the assembler was supplemented by tmg. Doug Mcllroy’s version 
of Bob McClure’s compiler-compiler. Using it Thompson wrote B, the evolutionary link between 
Martin Richards’s (Cambridge University) BCPL and C. The PDP-11 assembler, a desk calculator 
dc. and B itself were written in B to bootstrap the system to the PDP-11. Because it could run 
before the disk had arrived, dc— not the assembler— became the first language to run on our PDP- 
11. Soon revised to handle arbitrary-precision numbers (vl), dc was taken over by Bob Morris and 
Lorinda Cherry. It now ranks as the senior language on UNIX systems. 

CC (v2 page 52) 

As a testbed for floating-point routines in vl Thompson wrote bos, a Basic-like interpreter. It 
survived as long as we used PDP-1 Is. V2 saw a burst of languages: a new tmg. a B that worked in 
both core-resident and software-paged versions, the completion of Fortran IV (Thompson and 
Ritchie), and Ritchie’s first C, conceived as B with data types. In that furiously productive year 
Thompson and Ritchie together wrote and debugged about 100,000 lines of production code. 

Conversion to C made- UNIX, already elegant and capable, into a system also intelligible, pli- 
able, and ultimately portable. It elicited a flood of utilities and made it easier to refine the kernel. 
As the compiler evolved, the system benefited too: better object code meant speedups and space sav- 
ings across the board. More than once an overgrown kernel was squeezed back into place by attend- 
ing to the compiler. 
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Portable utilities written in C spread easily to other cptfiputing environments at Bell Labs. 
Gradually users became able to deal with systems from several manufacturers on the same terms: 
programs like Is. cp, and above all sh worked similarly everywhere. Wiih the human, if not the 
machine interfaces already established, the ultimate transition, to UX systems proper on mainframes 
was remarkably gentle. J 

YACC (*3 page 53) 

With yacc Steve Johnson reduced to practice A1 Aho’s expertise in language theory (v3). 
Yacc, abetted by Mike Lesk’s lex (v7), stimulated a language industry. Among the better known 
yacc- based processors are 

eqn for typesetting equations (Kernighan and Cherry, vS) 

ratfor, which provided C-like syntax for Fortran (Kernighan, v6) 

be for arbitrary-precision computation (Morris and Cherry, v6) 

m4, a general macroprocessor (Kernighan, v7) 

apl, Iverson’s language (Thompson, v7) 

struct, convert Fortran to Ratfor (Brenda S. Baker, v7) 

J77, a Fortran 77 compiler (Feldman and Weinberger, v7) 

awk. a pattern-directed file-processing language (Aho, Weinberger and Kernighan, v7) 

pcc. a portable C compiler (Johnson, v7) 

pic for typesetting line drawings (Kernighan, v8) 

ideal, a constraint-based language for typesetting line drawings ( Chris ( Christopher J.) Van 
Wyk, v8), 

C++, an “object-oriented” extension of C (Bjarne Stroustrup, v8) 
hoc. a C-like “desk-calculator” language (Kernighan and Pike, v8) 
grap for typesetting graphs (Kernighan and Jon L Bentley, v9) 

Several of these languages are tours de force : eqn for its insightful syntax, bc-dc for its unique 
variable-precision math library, struct for finding both structure and theorems in undisciplined code, 
ideal for enlisting symbolic computation in the service of drafting. Yacc. by eliminating much 
drudgery of compiler-writing, made possible the extensive experimentation that underlies these novel 
languages. It is no exaggeration to say that without yacc some would never have been undertaken, 
and many would not have evolved into more than mere demonstrations. 

4. Applies done 

4.1. Text Processing 

Among the early justifications for the research activity that produced the UNIX system was 
the potential for text-processing. Thus the first significant application program was roff, which 
printed the manuals for vl, v2, and v3 (Thompson and Ritchie) and attracted the first outside 
client, the patent department at Bell Labs. 

Thereafter Joe Ossanna became the driving force behind UNIX text formatting software. His 
macro-based, trap-driven nroff appeared in v2. When Graphics Systems, Inc., announced an inex- 
pensive typesetter with ASCII paper tape input, Ossanna sprang for one, replaced the tape reader 
with a wire to the computer, and modified nroff for multiple fonts and proportional spacing. Voila. 
troff It blew the manufacturer’s mind, and touched off a flurry of homemade documents in flam- 
boyant layouts— good enough however, to fool referees into suspecting that the manuscripts had 
been published before. 

Ossanna’s ultimate intent, that macros should foster higher-level typsetting languages, was 
finally realized with the invention of the -an macros (Lesk, v7, but dating from 1976). 
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FORM (tl p«(e 54), TYPO (»3 page 55) 

“Text processing” means considerably more than mere text formatting. The elegant form 
letter generator was written by Thompson from Morris’s original on CTSS (vl). Augmented by a 
special editor fed (Cherry, v2) form provided a genuine personal database. McMahon, Morris, and 
Cherry together collected a substantial corpus of text and studied it statistically [8]. Some of their 
tools, particularly uniq (Thompson. v3) and comm (McMahon, v4) became staples. Out of that 
work came the remarkable typo, which spotted typing errors by statistical inference (Morris and 
Cherry, v3). Eventually Steve Johnson’s spell, a virtuoso demonstration of tools in use (see page 
126 of [6]), shouldered typo aside (vS) and spurred Mcllroy to engineer a sophisticated version 
(v7). 

Form was really a macroprocessor with persistent memory. The long tradition of macros at 
Beil Labs assured that others would appear: m6 by Mcllroy, Morris and Andrew D. Hall, then m4 
(Kernighan and Ritchie). And macros of course were central to the text formatters, roff nr off, and 
"off. 

OV (t 3 page 56) 

Ov did multicolumn formatting cheaply and elegantly (Ossanna, v3). One printed a narrow 
column with every other page offset one-half a page width and then ran the output through ov, 
which or-ed pairs of pages together. The following 4-column wonder was shown off on the first day 
of pipes: 

roff file >ov>ov> 

which means in modern language, roff file ! ov ! ov. Ov was ultimately killed off by pr 
-n and features built into nroff (v5). 

WWB (»8 page 57) 

Cherry’s work on approximate parsing and Aho’s on fast pattern search turned out to be just 
the right foundation for an English style-appraiser suggested by Prof. William Vesterman of 
Rutgers. That in turn was elaborated into Writer’s Workbench by Nina ( Antonina H.) Mac- 
Donald and others in the Human Performance Engineering Department (v8). WWB attracted 
unusual attention from the popular press, including the New York Times and the Today show. 

4.2. Narigadoa 

SKY (v4 page 58) 

By some quirk of providence, many members of the group have been fascinated by navigation, 
geodesy, and astronomy. The first celestial program was Ossanna’s satellite predictor, azel, which 
had guided the ground statioo for Telstar (v2). Morris’s, then Thompson’s sky programs predicted 
everything else, giving daily voice and mail announcements like, “Eclipse of the moon at 8:42 PM.” 
Mcllroy’s map, intended to display the earth on dozens of projections (v7), was used by McMahon 
to portray the heavens. Upon databases of maps, stars, cities, airports, and weather were built route 
planners for car ( blitmap , Leak and Elliott, v8) and plane (Thompson) and an astronomer’s infor- 
mant (scat. Pike, v9). 

WWV (t8 page 59) 

Already in vl were routines, cal (Thompson) and crime (Ritchie), that knew calendrical facts 
well beyond any immediate system need. In the 1980s, as the lab’s work spread across a network of 
machines, the many aberrent clocks became intolerable. Andy Koenig made the most of a cheap 
and jittery receiver for the National Bureau of Standards broadcast time standard wwv, arranging 
for individual clocks to adjust to the standard smoothly, without backdating. Later Condon installed 
and Thompson programmed a robust filter for a raw time receiver on an almost uninterruptable 
computer called “the rock” (v9). 
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4.3. Desip Automation 
CDL (»7 paps 60-63) 

Although most users do not encounter the UNIX Circuit Design System, it has long stood as 
an important application in the lab. Originated by Sandy Fraser and extended by Steve Bourne, Joe 
Condon, and Andrew Hume, UCDS handles circuits expressed in a common design language, cdl. It 
includes programs to create descriptions using interactive graphics, to lay out boards automatically, 
to check circuits for consistency, to guide wire-wrap machines, to specify combinational circuits and 
optimize them for programmed logic arrays (Chesson and Thompson). Without UCDS, significant 
inventions like Datakit, the S620 Blit terminal, or the Belle chess machine would never have been 
built. UCDS appeared in only one manual, v7. 

5. Communication 
TSS (v2 pap 64) 

The members of the research group had no desire to isolate themselves from the rest of the 
Beil Labs computing community. Nor could they at first justify the purchase of equipment such as 
line printers and tape drives, which cost more than their whole computer. Thus, besides dial-up 
access, which was a sine qua non. communication with other machines was a necessity. A 2000bps 
link provided remote job entry to the GECOS system at the Bell Labs computer center (opr, 
Thompson, v2). GECOS guru Charlie Roberts contributed tss to exploit the link for remote login 
and interactive file transfer (v2). Similar programs to communicate with IBM mainframes fol- 
lowed. 

Unlike most of the basic facilities of the system, which distilled years of well-established prac- 
tice, computer-to-computer communication has been a subject of almost continuous experimentation. 
The need to connect to foreign systems exacerbates the problem of making a coherent model for 
communication. Ken Thompson more than once returned to ground zero, building experimental 
communication-based systems from scratch. 

NFS (?7 pages 65-66), DCON (v8 pap 67) 

Sandy Fraser, aided by Jane Elliott, made our first local-area net. Spider, and its far-more- 
than-local-area successor based on the Datakit switch. Spider provided n/s. a remote network file 
store for a dozen minis (v7). Greg Chesson wrote remote-connection programs for direct machine- 
to-machine links. These programs, ultimately to become deon (Chesson) and rx (Pike) for remote 
login and execution, were adapted to Datakit as soon as it became available. More recently they, 
and connection programs for other networks, have been reworked to exploit a general server 
mechanism by Ritchie and Presotto (v8). 

Datakit connections sparked a version of the standard 10 library that gave access to remote as 
well as local files (Fraser and Priscilla Lu). Ritchie’s work on IO streams eventually made possible 
Weinberger’s network file system, /n, which provided remote access through the kernel. Not to be 
confused with the central file server for Spider, Weinberger’s file system is simply the union of all 
the files across all communicating machines. There is no manual page about how to use it because 
there is nothing to say. Remote file systems are “mounted” locally so that remote accesses look just 
like local accesses. 

6. Security 

SU (vl pap 68, *8 pap 69) 

Whether the system was actually run securely or not, considerable care has always been taken 
to assure that it is possible to do so. Permissions and Ritchie’s patented set-userid mechanism were 
already supported in vl. From Cambridge, England, came the idea of password encryption that 
went into v3. 

Trojan Horse tricks and countermeasures were discovered in an ongoing game that has been 



• 14 - 


recounted by Morris and Fred Grampp [4], Notice, for example, the removal of login(\) to chapter 
8 and the intrusion of /etc/ into the synopsis for su (Grampp, v8). These fillips defeated the old 
chestnut of leaving programs named login or su lying around in hopes of capturing a password 
typed by an unwary system administrator. Other subtle features of the modern su: dot is excluded 
from the shell search path and the burglars’ favorite shell variable ZFS is reset. 

CRYPT (v3 pag© 70, v§ page 71) 

Morris's first file encrypter appeared in v3 with the explicit intent to stimulate code breaking 
experiments. Stimulate it did. Morris himself broke crypt by hand. Later Ritchie automated the 
cryptanalysis using a method of Jim Reeds (Berkeley). Completed with an editor interface, a new 
crypt went public in v7. It also succumbed to an attack by Reeds and Weinberger— and fortunately, 
too: more than one person who locked data in crypt and threw away the key has been rescued by 
code breakers. 

But the still arduous process of code-breaking is not the easiest way to attack crypt. A simpler 
gambit is to catch a system administrator off guard and install a Trojan horse in crypt itself to 
snatch every new secret as it passes by. Thus the very presence of crypt may have just the opposite 
effect on security from what was intended. 

Even if crypt were perfectly safe, it would be unwise to encrypt files of lasting value. It is too 
easy to lose the key, either inadvertently or deliberately. Consequently crypt has been demoted to 
the games chapter (Grampp, v9). 

7. Curiosities 

NUMBER (v6 page 72) 

This filter that converts numbers to check-writing form was whipped up by Thompson (v6) to 
preprocess input to speak, which converted English to phonemes for a Votrax speech synthesizer 
(Mcllroy, v3).* Number was the glue with which Thompson fashioned a talking desk calculator: 

dc ! number ! speak 

The talking calculator could also be reached from an audio shell, through which, with some effort, 
the whole system could be run from a Touch-Tone phone. 

DSW (vl page 73) 

The nostalgically named dsw was a desperation tool designed to clean up files with unutterable 
names. This had been done on the PDP-7 by a program with console switch input; hence the sobri- 
quet “delete from switches.” It survived from vl until it was displaced by rm -i (Ritchie, v7). 

DD (? 5 page 74) 

Originally intended for converting files between the ASCII, little-endian, byte-stream world of 
DEC computers and the EBCDIC, big-endian, blocked world of IBM, dd was endowed with an 
appropriately bastard syntax (Thompson, vS). Pike has noted a cultural quirk. Much as families 
perpetuate the quaint sayings of children, users are wont to invoke dd with the JCL-ish formula, dd 
if ■ input of "output, or perhaps with cat input S dd of *output, but rarely with the ele- 
mentary utterance dd < input >output. 


• The UNIX lab was then the only place in the world where one could hear arbitrary teat uttered by a machine on 
the spur of the moment. Visitors did a double-take upon being greeted by name. One bapies* lounger listening to 
the fun from outside the lab door fled at a sudden sentence, “Stop meuing around and get some work done." 
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FACED (r9 page 75) 

Among the novelties inspired by bitmapped terminals was Pike’s and Presottos’s face server, 
which provides pictures of all users. The face server, like Weinberger’s network file system and 
Killian's /proc directory of running core images, is a process that functions as a file system: it 
interprets file names upon open — in this case as connections to a remote repository— and delivers 
data upon read. 

By far the most popular application of the face server is Luca Cardelli’s vismon, which 
announces incoming messages with pictures of their senders. 

Enigmatic images resembling that on the FACED page have frequently and inexplicably 
appeared on organization charts, posters, magazine covers, construction fences, and even a water 
tower. 

8. Front matter 

Titles and introductions (pages 76-96) 

This chronological set of front matter comprises all title pages and prefaces plus samples of 
introductions and tables of contents. 

In a bow to user-friendliness, Ritchie added “How to Get suited” to the introduction for v3. 
At the typographic watershed where the manual was converted from roff to troff there appeared the 
thinnest, least forbidding UNIX Programmer’s Manual of all time, v4 (pages 88-89). For v6 and v7 
Lorinda Cherry prepared a pocket reference, familiarly known as the “Purple Card,” which is not 
shown. Thompson gathered a set of Documents for Use with UNIX, also not shown, to accompany 
v6. Kernighan expanded the collection for the v7 manual, but nobody has had the ambition to 
modernize “Volume 2” since. Doug Mcllroy compiled a glossary for the trade book form of v7 [2] 
and all later editions (page 94). Cherry prepared the topical uble of contents for v9 (page 96). 

Page 97 touches on software by Pike et al. for the Teletype 5620, the terminal of choice for v8 
and v9. With a megabyte of memory and downloadable programs, the 5620 is a computer system in 
its own right. This fact is reflected in the organization of chapter 9 into subchapters parallel to the 
usual chapters: commands, system calls, subroutines, dau layouts, games, etc. The 5620 software 
outweighs that of the original vl in bulk, and offers a similar number of “primitive” functions. 
These facilities radically change the feel, but not the principles, of the UNIX system. Significant as 
it is, the 5620 software has been deliberately slighted in these readings about the common descent of 
UNIX, because the work is still tied to one kind of hardware and because it strikes off in new direc- 
tions that more properly belong to a sequel. 

Tables of contests (pages 98-114) 


9. Ackaowkdgmeats 

Many of the people mentioned have willingly provided fresh recollections, unearthed sources, 
and commented on drafts. I am grateful for the generous help of L. L. Cherry, J. H. Condon. R. J. 
Elliott, B. W. Kernighan, A. R. Koenig, L. E. McMahon, R. Pike, D. M. Ritchie, K. Thompson. P. 
J. Weinberger, and Norman Wilson. The selection of materials and whatever inaccuracies or over- 
sights remain mine and mine alone. 
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NAME 

SYNOPSIS 

DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 


cat — concatenate and print 
file, ... 

ca£ reads each file in sequence and writes it on 
the standard output stream. Thus: 

cat file 

is about the easiest way to print a file. Also: 
cat f 11 el f lle2 >f Ile3 

is about tha easiest way to concatenate files. 

If no Input file is given cat reads from the 
standard input file. 


pr, cp 

none; if a file cannot be found it is ignored. 


OWNER 


hen , dmr 
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CP ( I ) 

NAME 

cp — copy 

SYNOPSIS 

SR «il « 12 filt 21 fil « 22 ... 

DESCRIPTION 

Pil«« ere taken in pairs; th« first is opened for 
reading, the second created mod* 17. Th*n the 
first is copied into the second. 

PILES 

— 

SEE ALSO 

cet, pr 

DIAGNOSTICS 

Error returns are checked At every system call, 
and appropriate diagnostics are produced. 

BUGS 

The seeond file should be created in the mode of 
the first. 

A directory convention as used in my should ba 
adopted to co. 


OWNER 


ken, dor 
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CPU) 




cp - copy 

svNona 

cp ( -t 1 AJel fli«2 
dcscuptton 

Th« flrst flit is copied onto the second. Th« matu , 

alf^y existed: the mode of the source Ale is used otherwise* Ur * #l fl,< 4,6 Preserved if u 

ItfiUJ is t directory, then the tsnet Ale is « Ale in that directory with th« Ai-n. , 4 
No one is quite sure whet the fl* -t ** h fl, *‘ n * n w of filtl. 

sex UJO 

<»t (D. pr OX rav © 

BUGS 


Copying » flle onto itseif destroys its contents. 
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NAME 

SYNOPSIS 

DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 


sort — sort a file 
sort input output 

ZilLT' 

actir*! 1 * S " CoUatln * *n<J P l fn0 r.d r *h 1; 


OWNER 


<±nr, ken 
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SORT;, 


NAME 


SYNOPSIS 

sort [ 


sort — sort or merge flies 

ibdnrtr J [ +por [ —pas ; 


( —mo | [ name 


FILES 


description 

TnH'JSnSJd^t 11 ? 2? t u^ th ? ,Undard 0 fi utput The "«>• •- 

Thus son may bo used as a Alter. P “ ao UMd lf no in P ut file names are given. 

fsL’ZZStr " 

* Do not map lower case letters. 

b b,tnks Spaces and tabs) art not included in fields. 

* ° IC “°"7' ^ k ' Un - d *“ *" d “• »w«cmi in ASCII compemone 

to,Z't,r!r24£ n 5 r,2 ns** <»» »« opiiomiiy ^ 

r Reverse the sense of comparisons, 
t* Tab character between Adds is * 

SSTiraJ r^Sy*** 37 j? 7 S.' ’i* «* • «*yw. ft- *« *. 

funn« in. „„ a. A mSEr.5 Sut *L ^ 'Z <0 «P 

denotes the first position after the kev of u** * bsfinmns of the key; 

overridden for . peracule, key b, lependin,’ on. or rj£o* "Ce^S’TpS m *’' * 

S. "under .“C.y «"* *"» 

iwn specified. . Held is .Turn, .nine JbrtSSw 1 ” ,n * “ 6 

KJrjyraf 111 — « — —. 

Thsie flag arguments are also understood! 

-m Merge only, the input Ales are alreedy sorted 

th# “T ®f ™ out * ut «'• » use instead of the standard output Th.s 
file may be the same as one of the inputs, except under the merge flag -m 

/usr/tapfam??? 
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MAIL (I) 


NAME 

SYNOPSIS 

DESCRIPTION 


mall ®end mall to another user 

ma ll C letter person ... ] 


-«Ti L argument searches for a file 
, SilllSS* prints it If present, and asks i* 

it should be saved, if the answer ii V thl 
nail is renamed mail, otherwise it is deleted 

t0 th * 4fcov « question may be supplied 
in the letter argument. pp 1 “ 


When followed by the names of a letter and one or 
more people, the letter is appended to each 

person s majlfrgE* Each letter is preceded bv the 
sender s name and a postmark. 9 y th * 

i , * lth *r the name of an entry in the 
directory ^ui£, in which case the mail is sent to 
/HJ£/ai£12|7mSiii2«, or the path name of a direc- 
tory, in which case maHfeg« m that directory is 


Inlm of U mIil 109 ‘ ln h * i# lnforn#d of th « pres- 


FILES 

SEE ALSO 
DIAGNOSTICS 

BUGS 


/etc/uids to map the sender's nvanerical user id 
to name; ra^li and mailbox in various directories. 

lnlt 


Who are you? if the user cannot be identifec 
for some reason (a bug). Cannot send to user* 
if mailbox cannot be opened. 


OWNER 


ken 
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NAME 

mail - send or receive mail among users 

SYNOPSIS 

mail person ... 

mail I -r I ( -q I ( -p I l -f file I 
DESCRIPTION 

Va//with no argument prims a user’s mail, message-by-message, in last-m. first-oui order. :he 
optional argument ~r causes first-in. first-out order. If the —p flag is given, the mail is printed 
with no questions asked: otherwise, for each message, mail reads a line from the standard input 
to direct disposition of the message. 

newline 

Go on to next message, 
d Delete message and go on to the next, 
p Print message again. 

- Go back to previous message. 

s ( tile 1 ... 

Save the message in the named hies ('mbox' default). 

w ( hie I ... 

Save the message, without a header, in the named files (‘mbox’ default), 
m ( person ) ... 

Mail the message to the named persons (yourself is default). 

EOT (control-D) 

Put unexamined mail back in the mailbox and stop, 
q Same as EOT. 

x Exit, without changing the mailbox file. 

'command 

Escape to the Shell to do command. 

1 Print a command summary. 

An interrupt stops the printing of the current letter. The optional argument -q causes ~a p 
exit after interrupts without changing the mailbox. 

When persons arc named, mail takes the standard input up to an end-of-fite (or a line win 
’.’) and adds it to each person s ’mail’ file. The message is preceded by the sender's name * 
postmark. Lines that look like postmarks are prepended with *>’. A person is usually a 
name reco gnized by fofm(l). To denote a recipient on a remote system, prefix person 5 * -♦ 
system name and exclamation mark (see uucp(\)). 

The — f option causes the named file. e g. mbox'. to be printed as if it were the mail file 

Each user owns his own mailbox, which is by default generally readable but not writable 7*e 
command does not delete an empty mailbox nor change its mode, so a user may mate t 
unreadable if desired. 

When a user logs in he is informed of the presence of mail. 

FILES 

/usr/spool/mail/* mailboxes 
/etc/passwd tu identify sender and locate persons 

mbox saved mail 

/tmp/ma* temp file 


?th Edition 


3 / 15/72 


23 vl 


ECHO 


NAME 

SYNOPSIS 

DESCRIPTION 

FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 


echo — acho argument * 
acha C arg, ... ] 

echo writ#* all Its argumants in ordar aa a lino 
on tha standard output fila. It is mainly useful 
for producing diagnostics in eostnand files. 


OWNER 


doug 



GREP(l) 


24 v4 

3/3/73 


GREPUj 




SYNOPSIS 


grep - search a file for a pattern 


vtp [ -* | [ -I ] ( ) expression [input] (output) 

TIAkJ 


description 

SEI ALSO 

«KI). sh(I) 

BUGS 


Lines are limited to 512 characters; longer line 


1 *re truncated. 


• • l - 
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NAME 

SYNOPSIS 

DESCRIPTION 


SH [ I 


sh — shell (command interpreter) 

s£ [ name [ arg 1 ... [ arg 9 ] ] ] 

sh is the standard command interpreter. It is 
the program which reads and arranges the execu- 
tion of the command lines typed by most users. 

It may itself be called as a command to Interpret 
files of command lines. Before discussing the 
arguments to the shell used as a command, the 
structure of command lines themselves will be 
given. 

Command lines are sequences of commands separated 
by command delimiters. Each command is a se- 
quence of non-blank command arguments separated 
by blanks. The first argument specifies the name 
of a command to be executed, accept for certain 
types of special arguments discussed below , the 
arguments other than the command name are simply 
passed to the invoked command. 

If the first argument represents the path name of 
an executable^file, it is invoked; otherwise the 
string "/bin/" is prepended to the argument. (In 
this way the standard commands, which reside in 
"/bin", are found.) If this search too fails a 
diagnostic is printed. 

The remaining non-special arguments are simply 
passed to the command without further interpreta- 
tion by the shell. 

There are three eemmand delimiters: a the new 
line, and " 4 ". The semicolon ; specifies 

sequential execution of the commands so 
separated; that is, 

coma; comb 

causes the execution first^of command coma . then 
of comb . The aopersand 6 causes simultaneous 
execution: 

coma 4 comb 

causes ssgm to be called, followed immediately by 
comb without waiting for coma to finish. Thus 
coma and comb execute simultaneously. As a spe- 
cial case, 

coma 4 

causes coma to be executed and the shell ictmedi- 
ately to request another command without waiting 
for coma . 



Two character* causa tha iinnediately following 
string to ba lntarpreted as a spacial argument to 
the shell itself, not^passed to tha command. An 
argument of the form "<arg causes tha file arc 
to ba used as tha standard input file of the 
given command; an argument of tha form ">arg“ 
causes file "erg" to ba used as the standard out- 
put file for tha given command. 

If^any argument contains either of the characters 
"? " or "* , it is treated specially as follows. 

The current directory is searched for files^which 
match the given argument. The character in 

an argument matches any string of characters ir. a 
file name (including the null string); "?" 
matches any single character in a file name. 

Other argument characters match only the same 
character in the file name fc For example, 
matches all file names; °? matches all one-char- 
acter file namej; °ab® 0 s° matches alj f}le names 
beginning with ab and ending with .s . 

|f w the argument with or "?" also contains a 
/", a slightly different procedure is used: 
instead of the current directory, the directory 
used is the one obtained by taking the argument 
up to the last "/ before a "* or "?". The 
matching process matches the remainder of the 
argument after this "/" against the files in the 
derived directory. For example: "/usr/dmr/a # . s" 
matches all^files in directory ^/ush/^r" which, 
begin with "a" and end with ".s". 

In any event, a list of names is obtained which 
mateh tha argument. This list is sorted into 
alphabetical order, and the resulting sequence of 
arguments replaces the single argument containing 
the or The same^pjocess j^s carried out 

for each argument with a "* or ? (the result- 
ing lists are not merged) and finally the command 
is called with the resulting list of arguments. 

Fbr example: directory /usr/dmr contains the 
files al.s, a2.s, ...» a9.s. From any directory, 
the command 

as /usr/dmr/a?.s 

calls aj with arguments /usr/dmr/al . s , 
/usr/dmr/a2.s, ... /usr/dmr/ a9.s in that order. 

The character "\" causes the immediately follow- 
ing character to lose any special meaning it may 
have to the shell; in this way < , > , and 

other characters meaningful to the shell may b 
passed as part of arguments, A special case o 


in <t> 
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FILES 
SEE ALSO 

DIAGNOSTICS 


BUGS 


vL 


this feature allows the continuation of command* 
onto more than one line: a new-line preceded by 
"\" is translated into a blank. 

Sequences of characters enclosed in double (") or 
single (') quot.es are also taken literally. 

When the shell is invoked as a command, it has 
additional string processing capabilities. Re- 
call that the form in which the whell is invoked 

is 


sh [ name [ arg 1 ... [ arg g ] ] ] 

The name is the name of a file which will be read 
and interpreted. If not given, this subinstance 
of the shell will continue to read the standard 
input file. 

In the file, character sequences of the form 
»n", where n.i* a digit 0, ...» 9, are replaced 
by the nth argument to the invocation of the 
shell (arg ). " $0 " is replaced by name . 

An end-of-file in the shell's input causes it to 
exit. A side effect of this fact means that the 
way to log out from UNIX is to type an end of 
file. 

/etc/glob 

[reference] , which gives the theory of operation 
of the shell. 

"?", in case of any difficulty. The most common 
problem Is inability £o a find the given command. 
Others: input file ( <") cannot be found; no 

more processes can be created (this will allevi- 
ate itself with the passage of time). Note that 
no diagnostic is given for inability to create an 
output ( ">" ) file; the standard output file has 
already been closed when the condition is 
discovered and there is no place to write the 
diagnostic. 

If a or "? " isjjsed, the glob routine is 
invoked; it types "no command if it cannot find 
the given command, and "no match if there^were 
no files which matched an argument with ? or 

e 

Better diagnostics should be provided. If a * 
or "?" is used, the command must be in /bin . 

(Not, for example, in the user's directory.) 
is actually a glob bug. 
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NAME ah — shell (command interpreter) 

SYNOPSIS sh c name [ arg, ... [ arg g ] ] ] 

DESCRIPTION 

sh is the standard command interpreter. It is the pro- 
gram which reads and arranges the execution of the com- 
mand lines typed by most users. It may itself be called 
as a command to interpret files of commands. Before dis- 
cussing the arguments to the shell used as a command, the 
structure of command lines themselves will be given. 

Command lines 

Command lines are sequences of commands separated by com- 
mand delimiters. Eaeh command is a sequence of non-blank 
command arguments separated by blanks. The first argu- 
ment specifies the name of a command to be executed. 
Except for certain types of special arguments diseussed 
below, the arguments other then the command name are 
passed without interpretation to the invoked command. 

If the first argument is the name of^an executable file, 
it is invoked; otherwise the string "/bin/" is prepended 
to the argument. a (In^this way most standard commands, 
which reside in /bin ,„are found.) If no such command is 
found, the string a /usr is further prepended (to give 
"/usr/ bin/command") and another attempt is made to exe- 
cute the^resulting file. (Certain "overflow" commands 
live in "/usr/bin .) If the "/usr/bin" file exists, but 
is not executable, it is used by the shell as a command 
file. That is to say it is executed as though it were 
typed from the console. If all attempts fail, a diagnos- 
tic is printed. 

The remaining non-special arguments are simply passed to 
the command without further interpretation by the shell. 

Command delimiters 

There are three command delimiters; the new-line, 
and ”&"• The semicolon specifies sequential execu- 
tion of the commands so separated; that is, 

coma; comb 

causes the execution first of command coma , then of comb . 
The ampersand "fc" causes simultaneous execution; 

coma fc comb 

causes coma to be called, followed immediately by comb 
without waiting for coma to finish. Thus coma and comb 
execute simultaneously. As a special case, 

coma A 
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causes coma to be executed and the ahell immediately to 
request another command without waiting for coma . 

Termination Reporting 

If a command (not followed by "&") terminate a abnormally, 
a mesaage la printed. (All terminationa other than exit 
and Interrupt are conaidered abnormal.) The following ia 
a list of the abnormal termination meaaageat 

Bus error 
Trace/BPT trap 
Illegal lnatructlon 
IOT trap 
Power fail trap 
EMT trap 
Bad ayatem call 
Quit 

PIR trap 

Floating exception 

Memory violation 

Killed 

User I/O 

Error 

Iff a core image is produced, " — Core dumped" is append- 
ed to the appropriate mesaage. 

Redirection of f/Q 

Three character sequences cause the immediately following 
string to be interpreted aa a special argument to the 
shell itself, not passed to the command. 

An argument of the form "<arg" eauaes the file arg to te 
used as the standard input file of the given command. 

An argument of the form ">arg" causes file "arg" to be 
u sedges the standard output file for the given command. 

Arg is created if it did not exist, and in any case is 
truncated at the outset. 

An argument of the form ">>arg" causes file "arg" to be 
used a ss the standard output for the given command. If 
arg did not exist, it is created; if it did exist, the 
command output is appended to the file. 

Plfiej ang F.UUrf 

A pine is a channel sueh that information can be written 
into one end of the pipe by one program, and read at the 
other end by another program. (See aloe (II)). A filter 
is a program which reads the standard input file, per- 
forms some transformation, and writes the result on the 
standard output file. By extending the syntax used for 
redirection of I/O, a command line can specify that the 

- 2 - 
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output produced by a command be passed via a pipe through 
another command which acts as a filter. For examole : 

command >filter> 

More generally, special arguments of the form 
>f 2 >...> 

specify that output is to be passed successively through 
the filters f lt f 2l . ... and end up on the standard out- 
put stream. By slying Instead 

>*i>f 2 >...>*ile 

the output finally ends up in file . (The last ">" could 
also have been a >>" to specify concatenation onto the 
and of file . ) 

In exactly analogous manner input filtering can be speci- 
fied via one of 

<f]<fj<...<file 

Both input and output filtering ean be specified in the 
same command, though not in the same special argument. 

For examplet 

Is >pr> 

produces a listing of the current directory with page 
headings, while 

Is >pr>xx 

puts the paginated listing into the file xx. 

If any of tha filters needs arguments, quotes can be used 
to prevent tha required blank characters from violating 
tha blankless syntax of filters. For example! 

Is >"pr -h # My directory 4 ’ "> 

uses quotes twice, once to protect the entire ££ command, 
ones to protect the heading argument of ££. (Quotes are 
diseussed fully below.) 

Generation of arcument lists 

If any argument contains any of the characters "?", 
or * [ , it: is treated specially as follows. The current 
directory is searched for files whieh match the given 
argument. 
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The character in an argument matchee arty atring o £ 
character* in a file name (including the null string). 

The character "?" matches arty single character in a file 
name • 

Square brackets specify a class of characters 

which matches any single file-name character in the 
class. Within the brackets, each ordinary character is 
taken to be a^member of the class. A pair of characters 
separated by places in the class eaeh character lexi- 
cally greater than or equal to the first and less than or 
equal to the seeond member of the pair. 

Other characters match only the same character in the 
file name. 

For example, matehee all file names} "?" matches all 
one-character file najjief; °[§b^* 8 s° matehee all file 
names beginning with a or b and ending with ,s ; 
"?C*i-m1 matehee all tvo-charmeter file names ending 
with "s or the letters "i" through "m". 

If the argument with or ra ?“ also contains a "/", a 
slightly different procedure is usedt Instead of the 
current directory, the directory used £s w the one obtained 
by n taklng the argument up to the last /" before a or 
"?”. The matching p^ogeas matches the remainder of the 
argument after this / against the files in the derived 
directory. For example; "/usr/dmr/a*.s" matches all 
files in glrfctory “/usr/dmr" which begin with "a" and 
end with .s . 

In any event, a list of names is obtained which match the 
argument. This list is sorted into alphabetical order, 
and the resulting sequence of arguments replaces the sin- 
gle argument containing the "C", of "?"• The same 

process is earned out for eaeh argument (the resulting 
lists are not merged) and finally the command is called 
with the resulting list of arguments. 

For examples directory /usr/dmr contains the files ai.s, 
a2.s, ..., a9.s . From any directory, the command 

as /usr/dmr/a?.s 

calls aj with arguments /usr/dmr/al «s, /usr/dmr/a2.s, ... 
/usr/dmr/a9.s in that order. 

flaa&iflg 

The character "\" eauses the immediately following char- 
acter to lose any special meaning it may have to the 
shell; in this way < , *>“, and other characters mean- 
ingful to the shell may be passed as part of arguments. 

A special case of this feature allows the continuation of 
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command* onto mora than on* lina: a new-line preceded by 
\ la tranalatad Into a blank. 

Sa^vianeaa of charaetar* ancloaad In doubla (") or single 
( ) quota* a re also taken litarally. 

Argument passing 

Whan tha shall 1* invoked as a command, it has additional 
string processing capabilities. Recall that tha form in 
which tha shall is invoked is 

sh C name C arg, ... [ arg 9 ] ] ] 

Tha name is tha name of a file which will be read and 
interpreted. If not given, this subinstanee of tha shall 
will continue to read tha standard input file. 

In command lines in tha fila (nof in command input), 
charaetar sequences of tha form an , whara n to a digit 
0, . .., 9» era raplacad by tha nth argureant to tha invo- 
cation of tha shall (arg n ). SO is raplacad by name . 

End o£ file 

An end-of-file in tha shall' s input causas it to exit. A 
sida affect of this faet moans that tha way to log out 
from UNIX is to typa an and of fils. 

Special commands 

Two commands are treated specially by tha shall. 

"chdir" is dona without spawning a new process by execut- 
ing tha svs chdlr primitive. 

"Login* is dona by executing /bin/login without creating 
a new process* 

These peculiarities are inexorably Imposed upon the shell 
by the basic structure of the UNIX process control sys- 
tem* It is a rewarding exerelse to work out why. 

Command file errors t interrupts 

Any she 11 -detected error, or an interrupt signal, during 
the execution of a command file causes the shell to cease 
execution of that file. 

FILES /ete/glob, whleh interprets "•*, "?", and 

SEE ALSO "The UNIX Time-sharing System", which gives the 

theory of operation of the shell. 

DIAGNOSTICS 

Input not found , when a command file is specified which 


5 



SH (I 


BUGS 


J -' v3 

1 / 15/73 


cannot ba raad; 

Arg count , if tha numbar of arguments to tha chdir 
paaudo -command is not axaetly 1 , or if "■>" or " 

is usad inappropriately* * ' ’ 

"Bad directory", if tha diractory given in "chdir" cannot 
b® switched to? 

Try again , if no naw procass can ba craatad to execute 
tha specif ied^command} 

imbalanca , if singla or doubla quota* ara not 
matched; 

]]lnput fila" 4 if an argumant aftar "<" cannot ba raad* 
Outout fila , if an argumant aftar >" or "»" cannot ba 
written (or craatad)} 

Command not found" , if tha soaeifiad command cannot ba 
executed • m 

"no mateh", if no argumant s ara ganaratad for a command 
which containa • , ? 9 or [ . 

termination maasagas dascribad above. 

If any argumant contains a quotad *•*, or than 

all instance « of thasa eharaetara must ba quotad. This 
i*„b«eauaa jh^calla tha glob routina whanavar an unquotad 
* , ? , or [ is notiead} tha fact that othar in- 

stancaa of thasa eharaetara oceurrsd quotad is not no- 
ticad by glob . 

whan output is redirected, particularly through a filtar 
diagnostics tand to ba sant down tha pips and ara some- 
timaa lost altogathar. 


- 6 - 



34 v4 


SHU) 


4 / 18/73 


SHU) 


na.mj 

sh - shell (command interpreter) 
SYNOPSIS 

sh ( name ( irgl ... [ ar|9 ] 1 1 


otscumoN 

SM is the standard command interpreter. It is the proram which reeds and amntes the execu- 
i'“ ;f !. "■ .YWd w mo.. u-ri [. m» ,Mt b. c«M u . comJS.it to 
pret flies or commands. Before discussing the arguments to the Shell used as a command the 
structure of command linos thcmsalvaa will bo given. 

Commands. Each commend is a sequence of non-blank commend arguments separated by 
blanks- The flrsl argument speciAes the name of a commend to be execute* Except for cert^n 
typ« of special arguments discussed below, the arguments other than the command nai?e « 
passed without imarpretauon to the invoked commend. 5 

If the Arst argument is the name of an executable Ale. it is invoked: otherwise the string /bin/’ is 
prepemded to the argument (In this way meet standard commends, which reside m '/bin' u\ 
found.) If no such commend is found, the string ‘/uar’ is further prepended (to aive 
vuer/bin/commandT and another attempt is made to execute the resulting flic (Cmain le sser - 
usedcommande live m/uir/bin'.) If the Vuer/bin’ Ale exists, but is not executable, .t ,s usedby 

5f. Sh «? ,!* * comm * n f ft,# - That '« » say it is executed ae though it were typed from the con- 
sole. If all attempts fail, a diagnostic is printed. 

"T* ?* " mo « ®mmande separated by 1’ or **’ constitute a tmUrn. The sun- 
dard output of each command but the last in a pipeline is taken as the standard input of the next 
command. Each command is run as a separate p r o cess , connected by pipes (see pipe(II)) to .ts 
neighbor*. A commend tine combined in paremheaee 1 f mty appear in piece of a simple com- 
mend as an element of e pipeline: 


A command lint consists of one or more pipelines separated, and perhaps terminated by or 4 
The semicolon designates sequential execution. The ampersand causae the preceding pipeline to 
be executed without waiung for it to Anisli. The process id of such e pipeline is reported, so that 
it may be used if necenary for a subeaquent weir or ktlL 

Tenninatien Regertlng. If a commend (not followed by ‘41 terminates abnormally, a message is 
printed. (All terminations other then exit and interrupt are considered abnormal.) Termination 
reports for commends followed by * 4 ’ are given upon receipt of the Am command subsequent to 
the termination of the commend, or when e weir is execute* The following is e list of the ab> 
normal termination massage* 

Bub error 
TramfWT trap 
IDepI instruction 
lOTtra* 

EMT trap 
Bad system call 
Quit 

Rotting exception 
Memory violation 
Killed 

/ 

If a core image is produced. *- Coro dumped' is appended to the appropriate massage. 

Radlractleo ef I/O. There are three character sequences that cause the immediately following 
string to be interpreted « a special argument to the Shell itself. Such an argument may aopear 
anywhere among the arguments of a simple command, or before or after a parenthesized com- 
mend list, and is associated with that command or command list. 


An argument of the form '<arg' causes the Ale *arg' to be used ae the standard input Ale of the 
associated command. 
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An argument of the form ‘>arg' causes file 'arg' to be used as the standard output file for the as* 
sociated command. ‘Art’ is crested if it did not exist, and m any case is truncated at the outset 

An argument of the form ‘>>arg’ causes file 'art' to be used as the standard output for the associ* 
ated command. If 'art' did not exist it is crested: if it did exist the command output is append* 
ed to the file. 

For example, either of the command lines 

Is >junk: cat tail »junk 
( Is; cat tail ) >junk 

creates, on file ‘junk’, a listing of the workint directory, followed immediately by the contents of 
file ‘tail’. 


Either of the constructs ‘>art’ or ‘»art’ associated with any but the last command of a pipeline 
is ineffectual, as is ’<art' in any but the first 

Generation of argument lisa. If any argument contains any of the characters *•’ or it is 
treated specially a follows. The current directory is searched for Ilia which match the given ar* 
gument 

The character '** in an argument matches any string of characters in a (lie name (including the 
null string): 

The character ’?* matches any single character in a Ale name. 

Square brackets t-.f specify a class of characters which matches any single Alomame character m 
the class. Within the brackets, each ordinary character is taken to be a member of the class, a 
pair of characters separated by places in the class each character lexically greater than or 
equal to the Arst and less than or equal to the second member of the pair. 

Other characters match only the same character in the Ale name. 

For example. matches all Ale names; ’?’ matches all one-character Ale names: (abi* s’ matches 
all Ale names be*nnn« with ’a’ or b’ and ending with ’ s’: ’la-mr matches all two<harac:er 
Ale names ending with 'i or the letters *i* through ’m'. 

If the argument with *•* or 'V also contains a ‘A a slightly different procedure is used: instead z< 
the current directory, the directory used is the one obtained by taking the argument up to tnc am 
■r before a *’ or ’?*. The matching process matches the remainder of the argument after :nn 
against the Ales in the derived directory. For example: ‘/uer/drar/a' s’ matches all Ales m direct 
ry ‘/uar/dmr’ which begin with ‘s’ and and with vs’. 

In any event, a lisa of names is obtained which match the argument This list is sorted mto al- 
phabetical order, and the resulting sequence of arguments replacae the single arpunent containing 
the *'. T. or 'V. The mm process is earned out for each argument (the resulting lists are 
merged) and Anally the command is called with the resulting list of arguments. 

For example dir e ct ory /usr/dmr contains the Ales al.s. a2.s. ... a9.s. From any directory *e 
command 


as Aar/dmr/a?4 

calls as with arguments Aar/dmr/sl.s. /usr/dmr/als. ... /usr/dmr/a9.s in thst order. 

OueriM. The chvacter A* causes the immediately following character to lorn any spectai mean- 
ing .t may have to the Shell; in this way •<’. and other characters meaningful to the Sheii 
may be paaaed m part of arguments. A special cam of this feature allows the continuation of 
commands onto more then one line a new-iina preceded by *Y is translated into a feionte. 

Sequences of characters enclosed in double O or single 0 quotes iff also takan literally For 
example 


Is | pr -h 'My directory* 

causes a directory listing to be produced by is. and passed on ^to be pnntm wiih the ^d,^ 
My directory' Quotas permit the inclusion of blanks m the heading, which is a single argument 
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Af **"* Bl P*? 1 "*- Wh«" the Shell is invoked as a command, it has additional < tnn . 
capabilities. Recall that the form in which the Shell is invoked is ^ * proceM,n » 

sh ( name ( arg 1 ... ( arg& ) ] I 

'* th# nwn * of * Ale which will be read and interpreted. If not uven thi* , U h, n ,, 1( ,r* 
of the Shell will continue to read the standard input Ale ** ub MUnce 

In command lines in the Ale (not in command input). charmter sequences of the form Sn 

r*M JVjf by thi mh "» umtm “ «**• 'nvocauoToT?^Sh.ii (iiTso- , 

End ef tie. An end-of-Ale in the Shell's input causes it to exit A sids effect of this fact means 
that the way to lot out from UNIX is to type an EOT. Mns 

Special comma n d s . The following commands are treated specially by the Shell. 

cMr is done without spawning a new p ro ca m by executing jyt cMr an 

/apt* is done by executing /bin/login without creating a new procam. 

weir is done without spawning s new process by exscuung syt wait (111 

thift is done by manipulating the arguments to the Shell 

is simply ignored 

Command lie smia: iMarrupts. Any SheiKdetected error, or an interrupt signal, during the ex- 
ecuuon of s command Ala causes the Shell to cases execution of that Ala. ^ 

Procasa that art craatad with s ’ 4 ' ignore interrupts. Also if such a process hm not redirected its 
input with a '< . its input is automatically redirected to the zero length Ale /dev/nuil. 


nus 

/etc/glob. which interprets and T. 

/dev/nuil as a source of end<of-Ale. 

SCI ALSO 

The UNIX Timesharing System', which givm the theory of operation of the Shell, 
chdirfl). logind), wairfi). shiftd) 


BUGS 

When output is redirected. particularly to make a multicommand pipeline, diagnostics tend to be 
sent down the pipe and am someumea lorn altogether. Not ail components of a pipeline 
swawned with ‘ 4 * ignore interrupts. 


• 3 . 
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nJU* W 


NAME 

SYNOPSIS 

DESCRIPTION 


PILES 
SEE ALSO 
DIAGNOSTICS 

BUGS 


goto — command transfer 
goto label 

22£2 !»* «nly allowed whan th« Shall is taking 
commands from a file. Tha fila is saarchad (from 
tha baginning) for a lina baginning with fol- 
low ad by ona or mora spaeas followad by tha 

& such a llna is found, tha goto command 
raturns. Slnca tha raad polntar in tha command 
fila points to tha lina aftar tha labal, tha 
9tt9CZ is to causa tha Shall to transfar to the 
laballad lina, 

is a do-nothing command that only sarves to 
plaea a labal. 


• h<I), : ( I) 

^goto error", if tha input fila is a typewriter; 
labal not found • 


OWNS? 


dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 

PILES 
SEE ALSO 
D IAGNOST ICS 
BUGS 


— placa a labal 
j, [ labal ] 

: doas nothing. Its only function 1* to placa a 
Tabal for tha goto command. ^ is a command so 
tha Shall doasn t hava to ba ffixad to lgnora 
Unas with : 's . 


goto( I) 


OWNER 


dor 
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SYS STA7 



NAME 

SYNOPSIS 

DESCRIPTION 


FILES 


stat — gat file status 


sys stat; name; buf / stat = 18. 


ffrf.P® 1 ” 6 * to . a null -terminated string naming a 
file, buf is the address of a 34(10) byt© buffer 
into which Information i. pLc.d cone.™!^^* 
1S unnecessary to have any permission* 
at all with respect to the file, but all direc- 
tories leading to the file must be readable. 

After stat, buf has the following format: 


buf, +1 

♦ 2, +3 
+ 4 

♦ 5 

♦ 6 , *7 
+ 8 , *9 

* 22, +23 

♦24, *25, *26, *27 
♦28, *29, *30, ♦Si 
*32, *33 


i -number 

flags (see below) 
number of links 
user ID of owner 
size in bytes 

first indirect block or contents bloc< 

eighth indirect block or contents bloc* 
creation time 
modification time 
unused 


The flags are as follows: 


100000 

040000 

020000 

010000 

000040 

000020 

000010 

000004 

000002 

000001 


used (always on) 
directory 

has been modified (always on) 
large file 
set user ID 
executable 
read, owner 
write, owner 
read, non-owner 
write, non-owner 


SEE ALSO 
DIAGNOSTICS 

BUGS 

OWNER 


fstat 

Error bit (c-bit) is set if the file cannot be 
found. 

The format is going to change someday. 

>cen., dmr 
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STAT(II) 


NAMI 

sut - get Ale sutus 

SYNOPSIS 

(sut - 18.) 

sys am; name; bof 

ita^naiM, bvfl 
char 'name; 
struct 1 ®s4o a buf; 

DOCTUPTlON 

Naim points to • null-terminated string naming a Alt; bu/is the address of a 36(10) byte buffer in- 
to which information is placed concerning the Alt. It is unnecessary to have any permissions at 
ail with respect to the Ale, but all directories leading to the Ale must be readable. After itat buf 
has the following structure (starting oflbet given in bytes); 

struct ( 
char 
char 
int 
int 
char 
char 
char 
char 
int 
int 
int 
int 


The Asp are as follows: 

100000 i-node is allocated 

060000 2-bit Ale type: 

000000 plain Ale 
040000 directory 
020000 character-type special Ale 
060000 block-type s pe ci al file. 


010000 

larps Ale 


004000 

set ussr-ID on ei 

tecudon 

002000 

set poup4D on 


000400 

read fawner) 


000200 

write fawner) 


000100 

eaeaae fawner) 


000070 

read, write, execute (sms©) 

000007 

rad, writ* c na 

t« fathers) 


see also \ 

surd). fsutOD, MV) 

DIAGNOSTICS 

Error bit (c-bit) is set if the (lie cannot be found. From C. a -K return indicates an error. 


minor. 


inumber 

flags; 

nlinks; 

uid; 

gid; 

siaO; 

sizel; 

addrttk 

actimetth 

modtimetth 


/* +0: minor device of i-nods V 
r +1: major device V 
/• + 2 V 

r +4: see below V 

f° -*-6: number of links to Ale */ 

r +7: user ID of owner V * 

r +8: group ID of owner V 

/• +* high byte of 24-bat sia V 

r +U> low word of 24-bit sia V 

/* +12: block numbers or device number */ 

r +28: time of last accsa V 

/* +32: time of last modiAcation */ 
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stat • : • 


NAME 

stat. fstat - gat Alt status 
SYNOPSIS 

#lnclode < sy s/ types. h> 
#laclnde <sys/stat.h> 

stat(aatDt, buf) 

char *aaaa; 
struct stat *baf; 

fstatiAldet, buf) 
struct sut *buf; 


DESC1IPTION 

Sat obtains detailed information about a named Ale. Fmi obtains the same information about 
an open Ale known by the Ale descriptor from a successful open crest dup or pipt(2) call. 

Harm points to a null- terminated string naming a Ale; bvf is the address of a buffer into which 
information is placed concerning the Ale. It is unnecessary to have any permissions at all with 
respect to the Ale, but all directories leading to the Ale must be searchable. The layout of the 
structure pointed to by buf as deAned in <uath> is given below. St_modt is encoded accord- 
ing to the ‘#deAne’ statements. 


struct sut 

I 


devj st.dev; 
ino.t st_ino; 
unsigned short stjnoda; 


short 

stjtlink; 


short 

st.uid; 


short 

stjid; 


dev_t 

st.rdev. 


ofT_t 

st_size; 


time_t 

st.atime; 


time.t 

st_mtime; 


time t 

); 

st.ctime; 


#daAneS IFMT 0170000 

#deAne 

S 1FDIR 

0040000 

#deAne 

S.IPCHK 

0020000 

#deAne 

s.muc 

0060000 


sjfreo 

0100000 

#defae 

S.IFMPC 

0030000 

#daine 

SJFMP* 

0070000 


#de0ne5.ISUID 

0004000 

#da0neS.lSOlD 

0002000 

#deAneS.lSVTX 

0001000 

#daAnaS IREAO 

0000400 

#deAneS IWUTE 

0000200 

#daAneS.lEXSC 

0000100 


/* type of Ale V 
r directory */ 

/• character special V 
/• block special V 
/• regular V 

r multiplexed char special V 
/* multiplexed Mock special */ 

/* sat user id on execution V 
/• set group id on execution */ 
r save s wapped uxt even afur use V 
r read permission, owner */ 

/* write permission, owner V 
/* execute/search permission, owner V 


The mode Mu 0000070 and 0000007 encode group and others permissions (see chmod(l)) 
The duAwud types, im.t, aff_u dtm_t. name various width integer values; dtvj encodes major 
and minor device numbers; their exact deAnitions are in the include Ale <sys/types.h> <se* 
ypnii). 


7th Edition 
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STAT ■ ; 


When fildn is associated with a pipe, /stat reports an 
The size is the number of bytes queued in the pipe. 


ordinary file with restricted 


permissions. 


rr.anmf is the file was last read. For reasons of efficiency, it .s not set when a directory ,, 
searched, although this would be more loficai. is the time the file w«s last written or 

created. It is not set by changes of owner, group, link count, or mode, u ct,mt is set both 
both by writing and changing the i-node. - 6oth 


SEE ALSO 

ls(l), Alsys(S) 


DIAGNOSTICS 

Zero is returned if a status is available; - 1 if the file cannot be found. 
ASSEMBLE! 

(stat - 18.) 

sys stat; name; baf 


(fsiat - 28.) 

(file descriptor in rO) 

sys fstat: bef 


7 th Edition 
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PIPE (II) 

NAME 

SYNOPSIS 

DESCRIPTION 


SEE ALSO 
DIAGNOSTICS 

BUGS 


1/15/73 


PIPS ( TJ ) 


pip# — create • pip# 


•ys pip* / pip# ■ 42. t 

(file descriptor in rO) 


net in assembler 


Th# oio# system eell ereetee en I/O mechanism 
celled e pip#. Th# file descriptor returned can 
be used in both read and write operations, when 
the pip# is written, the data is buffered up to 
504 bytes at which tin# th# writing process is 
suspended. A read on the pip# will pic* up the 
buffered data. 


It is assumed that after th# oio# has been set 
up. two (or more) eoop#ratlng processes (created 
by subsequent for* calls) will pass data through 
the pip# with read and writ# ealls. 

Th# sh#ll has a syntax to s#t up a llnaar array 
of processes connected by plp«s. 

Read calls on an empty pip# (no buffered data) 
with only on# end (no synonymous fil# descriptors 
resulting from fork or dup ) return an end-of- 
211# . writ# calls under similar conditions ar# 
ignored* 

sh(l), read(XX). write(II), fork(XX) 

Th# #rror bit (e-bit) is s«t if 10 files ar# 
alraady op#n. 


1 



NAME 


intr 


set interrupt handling 


SYNOPSIS 

DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 


sys intr; arg / intr a 27. 

When arg is 0, interrupts (ASCII DELETE) are 
ignored. When arg is 1, interrupts cause their 
normal result, that is, force an exit . When arc 
is a location within the program, control is 
transferred to that location when an interruot 
occurs . 

After an interrupt is caught, it is possible to 
resume execution by means of an rti instruction; 
however, great care must be exercised, since all 
I/O is terminated abruptly upon an interrupt. : 
particular, reads of the typewriter tend to re- 
turn with 0 characters read, thus simulating an 
end of file. 


quit 


It should be easier to resume after an interruot, 
but I don't Know how to make it work. 


owner 


ken, dmr 
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SIGNAL (II) 


naMS 

signal - catch or ignore signals 

SYNOPSB 

(signal “ 49.) 

sys signal; slg; value 

signaKsig. hue) 
int (*faacKh 

oncumoN 

Whan the signal defined by sit is sent to tha currant procaes, it is to ba treated according to 
value. Tha following is tha list of signals: 

1 hangup 

2 intarrupt 
3* quit 

4* illegal instruction 

5* traca trap 

6* IOT instruction 

7* EMT instruction 

8* floating point excaption 

9 kill (cannot ba caught or ignored) 

10* bus error 

11* segmentation violation 

12* bed argument to sys call 

If value is 0. the default system action applies to the signal. This is processes termination with 
or without a core dump. If wo tm is odd. the signal is ignored. Any other even value specifies an 
address in the process where an interrupt is simulated. An RTI instruction will return from the 

interrupt As a signal is caught it is reset to 0. Thus if it is desired to catch every such signal, 

the catching routine must issue another signal call 

The starred signals in the list above cause core imagas if not caught and not ignored. In C. if 
func is 0 or l. the action is as described above. If fime is even, it is assumed to be the address of 
a function entry point When the signal occurs, the function will be called. A return from the 
function will simulate the RTI. 

After a fork, the child inherits all signals. The exec call resets all caught signals to default action. 
SIS ALSO 

kill a. 10 

DIAGNOSTICS 

The error Ml feMt) is set if the given signal is out of range. In C. a -1 indicates an error: 0 indi- 
cates success 

\ 
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NAME 

SYNOPSIS 

arg: 

DESCRIPTION 


STTY (II) 


•tty — sat mode of typewriter 

(file descriptor in rO) 

•y« stty; arg / atty - 31. 

a a a 

dersr? depar; moda 

aata mod# bits for a typawritar whose fila 
daaerlptor is paasad in rO. First, tha systam 
dalaya until tha typawritar la qulaaeant. Than, 
the^ argument derar 1® plaead into tha typawri- 
tar a receiver control and atatua raglatar, and 
dep>r 1* plaead In tha trananlttar control and 
atatua raglatar. Tha DC-11 manual muat ba con- 
sul tad for tha format of thaaa worda. For tha 
purpoaa of thla call, tha moat important role of 
thaaa arguaanta la to adjust to tha apaad of tha 
typawritar. 

Tha moda argumanta contains ssvaral bits which 
datarmlna tha system's traatmant of tha 
typawritar t 

200 avan parity allowad on input (a. g. for m37s 
100 odd parity allowad on Input 
040 rm mode: wax a up on all characters 
020 map CR into LF; echo L? or CR aa LF-CR 
010 echo (full duplex) 

004 map upper caaa to lower on input (a. g. *33) 

002 aeho and print tabs aa spaces 

001 Inhibit all function delays (a. g. CRTs) 

Character* with tha wrong parity, as datarrainad 
by bit* 200 and 100, are Ignored. 

In raw mode, every character la passed baex im- 
mediately to tha program. No erase or xill pro- 
cessing is don a | tha and-of-file character (EOT), 
the interrupt character (DELETE) and tha quit 
character (PS) are not treated specially. 

Mode 020 causes Input carriage returns to ba 
turned into newlines; Input of either CR or LF 
causae LF<* both to be echoed (used for G2 Tar- 
miNet 300's and other terminals without tha new- 
line function) . 

Additional bits In tha high order byte of tha 
moda argument are used to Indicate that tha ter- 
minal Is an IBM 2741 and to specify 2741 modes. 
These mode bits ares 


A b mm«a4 eel 4 as mm TV! Id 114 1 
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FILES 
SEE ALSO 
DIAGNOSTICS 

BUGS 


stty 


4000 use corrMpond«nc« cod# conversion on inpuc 
(currently ignored) 

Normal input and output code conversion for 2741 s 
is EBCDIC (e. g. 963 ball and corresponding key- 
board). The presence of the transmit interrupt 
feature permits the system to do read-ahead while 
no output is in progress. In 2741 mode, the low 
order bits 331 are ignored. 


stty(I), gtty(II) 

The error bit (e-bit) is set if the file descrip- 
tor does not refer to a typewriter. 

This call should be used with ears. It is all 
too easy to turn off your typewriter. 


own SI 


ken, dar 
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NAME 

loctl. stty, gtty - control device 


SYNOPSIS 

#include <s*tty.h> 


ioctK Aides, request, trip) 
struct sgttyb ••up; 

stty(flldes. argp) 
struct sgttyb *argp; 


gtty(flldes. argp) 
struct sgttyb *argp; 


DESCRIPTION 


loctl performs a variety of functions on character special Ales (devices) 
ous devices in section 4 discuss how iociI applies to them. 

For certain status setting and status inquiries about terminal devices, the 
are equivalent to 

ioctKftldes, TIOCSETP. argp) 
ioctKftldes. TIOCGETP, argp) 


The writeups of van- 
functions stty and gtty 


respectively; see tty( 4). 


The following two calls, however, apply to any open Ale: 

IoctKftldes. FIOCLEX, NULL); 
ioctKftldes, FIONCLEX, NULL); 

The Arst causes the Ale to be closed automatically during a successful 
second reverses the effect of the Arst. 


exec operation; 


the 


SEE ALSO 

stiy(l), tty(4). exec(2) 


DIAGNOSTICS 

Zero is returned if the call was successful; - 1 if the Ale descriptor does not refer to the kind of 
hie ror which it was intended. 

BUGS 

Strictly speaking, since tocrl may be extended in different ways to devices with different proper- 
ties. argp should have an open-ended declaration like 

union { street sgttyb ...; ... ) *argp; 

The important thing is that the size is Axed by ‘struct sgttyb*. 

ASSEMBLE! 

(ioctl • 54.) 

sys ioctl; Bliss; request; argp 

(stty - 31.) 

(Ale descriptor in rO) 
stty: argp 

(gtty - 32.) 

(Ale descriptor in rO) 
sys gtty; argp 


7th Edition 
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PR1NTFM1I) 


NAMI 

printf — formatted print 
SYNOPSIS 

printfTfonnat, art,, ...); 
char 'formal; 

DESCRIPTION 

Pnmf converts, formats, and prints its arguments after the Urn under control of the first arau- 
ment. The first argument is a character string which contains two types of objects: plain charac- 
ters. which are simply copied to the output stream, and conversion specifications, each of which 
causes conversion and printing of the next successive argument to pnntf. 

Each conversion specification is introduced by the character %. Following the %. there may be 

- an optional minus sign which specifies left adjustment of the convened argument in the 
indicated field; 

- an optional digit string specifying a field width; if the converted argument has fewer char- 
acters than the field width it will be blank-padded on the left (or right, if the left- 
adjustment indicator has been given) to make up the field width; 

- an optional period which serves to separate the field width from the next digit string; 

- an optional digit string (precision) which specifies the number of digits to appear after the 
decimal point, for e- and f-conversion, or the maximum number of characters to be print- 
ed from a string; 

- a character which indicates the type of conversion to be applied. 

The conversion characters and their meanings are 

d The argument is convened to decimal notation. 

0 The argument is convened to octal notation. “0" will always appear as the first digit. 

f The argument is convened to decimal notation in the style “(-Idddddd" where the 
number of d’s after the decimal point is equal to the precision specification for the argu- 
ment If the precision is missing, 6 digits are given; if the precision is explicitly 0, no di- 
gits and no decimal point are printed. The argument should be float or double 

e The argument is convened in the style “1-)d.ddde±dd" where there is one digit before 
the decimal point and the number after is equal to the precision specification for the 
argument; when the precision is missing, 6 digits are produced. The argument should be a 
float or double quantity. 

c The argument character or character-pair is printed if non-null. 

s The argument is taken to be a string (character pointer) and characters from the string are 
printed until a null character or until the number of character! indicated by the precision 
s pe cificat ion is reached; however if the precision is 0 or missing all charactsrs up to a null 
areprintsd. 

1 The argument is taken to be an unsigned integer which is converted to decimal and print- 
ed (the result will be in the range 0 to 653351 

' If no recognizable character appears after the %, that character is printed; thus % may be printed 
by use of the string %%. In no case does a non-existent or small field width cause truncation of 
a field; padding takes place only if the specified field width exceeds the actual width. Characters 
generated by printf are printed by calling putchar. 

SU ALSO 

putchar (III) 


- 1 - 
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Pl’TC, . PL'TW, 


FCREAT 


NAME 

SYNOPSIS 


DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 


putc, putw . fcreat, flush — buffered output 

mov $ filename , rO 

Jsr r5, fcreat; iobuf 

(get byte in rO) 

jsr rS.putc; iobuf 

(get word in rO ) 

jsr r 5, putw; iobuf 

jsr rS.flush; iobuf 


f creat creates the given file (rrccifc 17) 
up the buffer iohuf (sire 134(70) bytes); cut 
and cutw write a byte cr word respectively or 
the file; flush forces the contents of the bu 
to be written, but does not close the file, 
format c f the buffer is: 


iobuf : 


. *. *2 
. *2 


/ file descriptor 
/ characters unused in buff 
/ ptr to next free char act * 
/ buffer 


f creat sets the error bit (c-bit) if the file 
creation failed; none of the other routires r 
turn error inf creation. 


Before tertrir.ati.no, a program should call f lus - 
tc force out the last of the output. 

The user trust supply i ohuf . which. sh.cul J ; - 

a word boundary. 

kept in /etc/liba.a 

sys creat; sys writ*; getc, getw, fcpen 
error bit possible or. f crea t call 
buffers should be changed to 5 i 2 bytes. 


OWNER 


dmr 


o hi x: 
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STDIO ( 3S ) 


NAME 

stdio — standard buffered input/output package 

SYNOPSIS 

#1nclude <stdle.h> 

FILE *stdin; 

FILE *stdout; 

FILE *stderr; 

DESCRIPTION 

The functions described in Sections 3S constitute an efficient user-level buffering scheme. The 
in-line macros gete and pute(i) handle characters quickly. The higher level routines geo. /gets, 
xanf, fxanf, freed. puts. /puts, prinrf. /print/, /mite all use gete and pute; they can be freely inter- 
mixed. 

A ftle with associated buffering is called a stream, and is declared to be a pointer to a defined 
type FILE. Fopend) creates certain descriptive data for a stream and returns a pointer to desig- 
nate the stream in all further transactions. There are three normally open streams with con- 
stant pointers declared in the include fUe and associated with the standard open Ales: 

stdln standard input Ale 

stdeet standard output Ale 

stdetr standard error Ale 

A constant ‘pointer’ NULL (0) designates no stream at all. 

An integer constant EOF (-1) is returned upon end of Ale or error by integer functions that 
deal with streams. 

Any routine that uses the standard input/output package must include the header Ale 
< stdio. h> of pertinent macro definitions. The functions and constants mentioned in sections 
labeled 3S are declared in the include Ale and need no further declaration. The constants, and 
the following ‘functions’ are implemented as macros; redeclaration of these names is perilous: 
gete. gexhar, pute. putehar, /to/, /error, fil rim. 

SEE ALSO 

open(2). dose(2), read(2), write(2) 

DIAGNOSTICS 

The value EOF is returned uniformly to indicate that a FILE pointer has not been initialized 
with /open. input (output) has been attempted on an output (input) stream, or a FILE pointer 
designates corrupt or otherwise unintelligible FILE data. 


7th Edition 
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NAME 

SYNOPSIS 
DESCRIPT ion 


PILES 


SEE ALSO 
0 IAGNOST ICS 
BUGS 


CC — C COOpiltf 


£S C ... ofil« 1 ... 


eg is the UNIX C compiler, 
typ«* of arguments: 


It accepts three 


th« b obj«J? UrC * pro * rw,, 5 »ri C conpiiJ5! U ^Sd 

Hi*- .5 6 '.5ii:«5S ;,T-tS-r e af ' h * ,oi ~* 

f ° r *- e " ) 4rt to 

«™ 04d * r fiag argument a , or C-compatible 
obJ«et programa, typically produced by an earl ier 
eg run, or perhapa librarieSi of C-ccmLtlble 
routinea. Thaaa programa, together with tha 
raaulta of any compilations apacifiad, ara loaded 

(in tha ordar given) to produca an executable 
program with name a. out . wecucaoie 

* u PP r ** , a | the loading phaaa 

s Asur* #rror ln 4ny of th# ?o5ti " :; 


Input file 
loaded output 
tanporary (delated) 
compiler 
runtime at art off 
built in functiona, etc. 
ayatam library 

C reference manual (in preparation ) , bc(vi) 

Diagnostics are intended to be a elf -explanatory. 


fila.c 

a. out 

e.tmp 

/aya/e/nc 

/uar/1 ib/ertO.o 

/uer/lib/libe.a 

/uar/1 lb/1 lba. a 


OWNW 
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NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
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yacc — yet another compiler compiler 
/crp/ac 1/vaee [ <grammar ] 

Yacc converts a context-free grammar into a sat 
of tablaa for a aimpla automaton which axacutaa 
an LR( 1 ) parsing algorithm. Tha tablas ara pro- 
vidad in raadabla form on tha standard output and 
in b-compilar format on fila actn.b j tha program 
/crp/sc j/bpar.b will parsa strings using tha 
actn.b fila. 

If your grammar is too big for yace. you may try 
/crp/sc J/bigyace, soma of whosa slza limits are 
larger, and others smaller. 

actn.b output tablas 

actn.tmp temporary storage 

Note that these files are created in the 
invoker's directory® The file actn.tmp is only 
created by /crp/sc J/bigyace (see above). 

Yace manual, by scj (available from ek)j "lr 
P arsing , by A. V. A ho and S, C. Johnson, to be 
published. 

There are various diagnostics, but only one can 
be obtained in each run. 

The maximum number of terminal and non-terminal 
symbols is SO each, and this is not checked. 
There are undoubtedly other bugs too. 
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/ \ 

' / 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 


SEE ALSO 
DIAGNOSTICS 

BUGS 


form — form letter generator 
form proto arg 1 ... 

form generate* a form letter from a prototype 
letter, an aasoclatlve memory, arguments and in a 
special case, the current date. 

If form is invoked with the argument the fol- 
lowing files come into play: 

x.f prototype input 

x.r form letter output 

x.am associative memory 

form. am associative memory if x.am not found. 

Basically, form is a copy process from the file 
x.f to the file x.r. if an element of the -form 
\n (where $ is a digit from 1 to 9) is encoun- 
tered, The a*** argument is Inserted in its place, 
and that argument is then rescanned, if \0 is. 
encountered, the current date is inserted. If 
the desired argument hgs not been given, a mes- 
sage of the form "\n: is typed. The response 

typed in then is used for that argument. 

If an element of the form [name] is encountered, 
the name is looked up in the associative memory. 
If it is found, the contents of the memory under 
this name replaces the original element (again 
rescanned.) Jf the name is not found, a message 
of the form name: " is typed. The response 
typed I.&. is used for that element. If the asso- 
ciative memory is writable, the response is en- 
tered in the memory under the name. Thus the 
next search for that name will succeed without 
interaction. 


In both of the above eases, the response is typed 
in by entering arbitrary text terminated by two 
new lines. Only the first of the two new l. 4 nes 
is passed with the text. The process is instant- 
ly terminated if an end of file is encountered 
anywhere exeept in the associative memory. 

x.f input file 

x.r output file 

x.am associative memory 

form .am associative memory 

type 

"settup error" when the appropriate files cannot 
be located or created. 

"settup" is misspelled. 
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NAME 

SYNOPSIS 

DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 


1/15/73 


TYPO ( I ) 


typo — find possible typo's 
tvpo C z 3 ... 

typo hunt* through a document for unusual word*, 
typographic errors, and hapax legomena and print* 
than on tha standard output. 

All word* u*ad in tha doeunant ara printad out in 
dacraasing ordar of paeuliarity along with an 
indax of paeuliarity. An indax of 10 or mora is 
considarad paeuliar. Printing of eartam vary 
common English word* i* supprassad. 

Tha statistics for Judging words ara taken from 
tha documant itsalf $ with soma halp from Known 
statistics of English. Tha option supprassas 
tha halp from English and should ba usad if tha 
documant is wrlttan in t for example, Urdu. 

Roff and Nroff control Unas ara ignorad. uppar 
casa is mappad into lowar casa. Quota marks, 
vortical bars, hyphens, and ampersands ara 
strippad from within words, vords hyphanatad 
across linos are put back together. 

/tmp/ttmp??, /ate/salt, /atc/w2006 


yas, lots 

Because of the mapping into lower case and the 
stripping of special characters, words may ba 
hard to locate in the original text. 
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NAME 

SYNOPSIS 

DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 
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ov — overlay pagas 
ov [ fila ] 

ov ia a poatproeassor for producing doubla column 
formattad taxt whan using nroff(i). ov litarallv 
ovarlaya succassiva paira of 66-lina pagaa. 

If tha fila argumant ia missing, tha atandard 
input ia uaad. Thu a ov may ba uaad aa a filtar. 

nona 

nroff(l), pr( I ) 
nona 

othar paga langtha should ba paxnittad. 
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WWB(l) 


XAME 

wwb. stylo, diction, punct — writer* workbench 
SYNOPSIS 

**yte t option ] ... Ale ... 

( option I .. Ala ... 


Ala ... 

ww* wwb [ -aa J { J Ala ... 

DESCRIPTION 

Wwb eontroa many subprogram* documented in tba rata mem. For tba full traatmant use w»h 
wwb . but for quick uaa tba fo(ioann« wbproframa ara rTni , rt “* 6 

Siylt re port* on roadability, saatanoa length and structure. word length tad uaaaa. varb tvm. and 
saattaco apenen ia tba namad docuaanu <yp *' * Bd 

Dictio* prints all saatanoa* that contain phrnaa from a lint of bad ar -. 

-p pfite suppiiaa aa a ddi ti o n al private patten Ala; option -a skip* tba standard ossa. 

Suattt mads, from tba standard input, pbraaaa dapraoatad by dictiom tad propose* alternative*. 


£5£Z!l m,Uatm U “‘ mm “ n ° UW * Un<U * «««««• rub. and samanca* that eomain 


aa* i? P " P# ' - f0r ‘1- prnpmcmton p,c. .deal, 

prop, tqm.nftr. and ib/(l). Option ~mm overrides tba default macro package. The related 
option -ml skip* mm«*tyle Uses, and should be used if than an many lists of non-sentenca*. 

Other option* for ttyls ara: 


-a pnnt all samanca* with their length and roadability indax. 

“• P"« **• that begin wub aa expletive. 

pnnt all taatanem that contain a paasin verb. 

“leant print all samanca* longer than mum. 

-tmum print all saatanoa* wboaa readability index is (mater than 


“P print para of tpaoob of tba words ia tba document. 
SEE ALSO 

damff(l). spoU(l) 

■WHtw's Workbmck Urns' t dismal, /usr/man/manw/* 


BUOt 

Uaa of (inn standard formattiaf macros may causa i n oorrac * samanca brooks. 
Impantiam cannot Ttn rocognuad 


Pago I 
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NAMZ 

sky - obtain ephemerides 

SYNOPSIS 

sky 

DCSOUmON 

Sky predicts the apparent locations of the Sun. the Moon, the planets out to Saturn, sun of mag- 
nitude at least IS, and certain other cdasual objects including comet Kohoutek and M31. Sky 
reads the standard input to obtain a GMT time typed on one line with blanks separating year, 
month number, day. hour, and minute if the year is missing the current year is used. If a blank 
line is typed the current time is used. The program prints the azimuth, elevation, and magnitude 
of objects which are above the horizon at the ephemeris location of Murray Hill at the indicated 
time 

Placing a “1" input after the minute entry causes the program to print out the Greenwich Sidere- 
al Time at the indicated moment and to print for each body its right ascension and declination as 
well as its azimuth and elevation. Also, instead of the magnitude, the geocentric distance of the 
body, in units the program considers convenient, is printed. (For planets the unit is essentially 

A. U.) 

The magnitudes of Solar System bodies are not calculated and are given as 0. The effects of at- 
mospheric extinction are not included; the mean magnitudes of variable stars are marked with 

uS» 

For all bodies, the program takes into account precession and nutation of the equinox, annual 
(but not diurnal) aberration, diurnal parallax, and the proper motion of stars (but not annual 
parallax). In no case is refraction included. 

The program takes into account perturbations of the Earth due to the Moon. Venus. Mars, and 
Jupiter. The expected accuracies are: for the Sun and other stellar bodies a few tenths of seconds 
of arc. for the Moon (on which particular care is lavished) likewise a few tenths of seconds. F or 
the Sun. Moon and stars the accuracy is sufficient to predict the circumstances of eclipses and x- 
cuitations to within a few seconds of time. The planets may be off by several minutes of arc 

Information about the program may be obtained from its author. 

nus 

/usr/lib/Startab. /usr/lib/moontab 

SIS ALSO 

azd (VI) 

American Ephemeris end Nautical Almanac, for the appropriate years; also, the Explanatory S—++ 
mm to the Amencam Ephemeris and Nautical Almanac 

AUTHOP 

R. Morris 
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NAME 

wwv - pnnt and sot the date from accurate clock 
SYNOPSIS 

ww9 ( -te -f “i 1 


DESCRIPTION 

wwv connects to a clock synchronized with radio sution WWV 
time obtained. It accepts these arguments: 


With no argument it prints the 


-b 


-i 


-f 


Print both the WWV time and the system's 

Set the system's time to agree with WWV 
not be changed by more than 20 minutes. 

With -t, force the time to be set by WWV 
minutes. 


current idea of the time. 

You must be super-user. The system time can- 

even if the local time disagrees by more than 20 


Report time in UTC rather than local time. 


FILES 

/usr/adm/wtmp to record time-setting 

SEE ALSO 

date (I), utmp(3) 


BUGS 

The WWV dock has been observed to slip sync by an integral number of minutes or hours from the 
radio standard. 


Page 1 
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NAME 

cdl — circuit description language 
DESCRIPTION 

The circuit descriptions used by design aid programs place, wcheck. bdraw and . v rao ire 
expressed in the Circuit Design Language described below. A complete description has four 
main parts which must appear in the sequence: Package Descriptions. Board Description. Com- 
ponent Descriptions, then Circuit Description. The last of these can be generated automatically 
from circuit drawings made by the command draw. 

The elements of a circuit are as follows. 

signal The information that passes over a wire and is carried by a net of wires, 
chip A circuit component. 

package The physical unit which houses one or more chips, 
pin The point where a signal wire connects to a chip, 
board The physical unit on which packages are mounted, 

socket The device for mounting a package on a board. 

connector The interface between signal wires on the board and those external to the board. 

Chips, packages and sockets are grouped by type. All the items of one type exhibit the sarr. 
properties. Types, like signals, chips and connectors, are identiAed by name. Pins and socket 
are identiAed by number. 

A name is a string of up to 16 letters, digits or any of the symbols + -.1 with the restricts 
that the Arst character cannot be a digit. In the simplest case, no two names can be the sam 
but there is provision for dividing a circuit into modules so that a name in one module is nc 
confused with the same name appearing in another module. A name that is defined prior to th 
first .m command is global and must be unique. (The description of a module starts with m 
A name deAned within a module is a local name and must not be the same as either anotne 
name local to the same module or a global name. The full form of a local name consists of :n 
module name and the local name separated by a /. It cannot be longer chan 16 character- 
Within the text of one module description it is possable to refer to an element of anotne 
module by giving its full name. A name preAxed with is a global name. 

The circuit board and components mounted on it are described as rectangles. They are pos 
tioned so that their sides are parallel to one or other of the axes used to describe circuit boa 
geometry. The axes should be chosen so that the following are true. 

The origin of the coordinate system lies outside the board and the board is in the hr 
quadrant. 

When the board is loaded with dual-in-line packages, pin one of a package is the close 
pin to the board origin. 

The rows of pine on dual-in-line packages run parallel to the X axis. 

Measurements are expressed in hundredths of an inch. All are integers and have no excuc 
decimal point. Coordinates are expressed as pairs of integers spearated by /' The X coord 
nate appears Ant 

It is sometimes necessary to provide a list of coordinates. Invariably each coordinate >s assoc 
ated with a numbered item (pin number, socket number etc.). A one item list consists of 
item number followed by its coordinates as in. 

28 170/250 

A series of- equally spaced and consecutively numbered items can be described by giving 
Arst and last item descriptions and separating the two with *•’ as in 
28 170/250- 30 190/200 

(item number 29 appears at position 180/225). If the item numbers are equally spaced out - 
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consecutive a step size can follow the *•* as in 

12 200/700 -9 147 200/100 

(which describes the positions of items numbered 12. 21. 30 etc.) 

In the following list of commands, characters that must appear are written in bold type whtie 
character strings are identified by names in italics. Brackets ( and I enclose an optional item and 
vertical bar I indicates an alternative. A list of items and coordinates, written as described m the 
previous paragraph, is represented by 

setofl</»m coordinate 

Commands are separated by either newline or semicolon. A comment can appear on any line. 

It starts with a % and ends with a newline. 

Lines that do not start with a period are signal definition lines. They have the format 
name (pint ... I name (• stgnah 

The signal called name is described either as being connected to one or more pint or >s 
described as being equivalent to a previously described s*naL Signal descriptions of this form 
can appear after .c commands, in which case the pin numbers refer to pins on a chip, or they 
appear after .1 and .e commands, in which case the pins are those oo a connector. 

The commands are as follows. 

Package Description 

.k name ptns length width 

Define package type. Arguments are the package type name, the number of pms on each pack- 
age. and its overall dimensions. The length is the distance along the X axis and the width is the 
distance along the Y axis. Note: the pins for a package should be numbered consecutively from 
one even if that means inventing a few extra pins. 

.kp setoflpuMO coord) 

Package pin locations. One or more .kp commands following a .k command gives the list of 
pins and their coordinates relative to the origin of the package. (By convention, the origin of a 
dual-in-line package is that corner of the package closest to pin number one.) 

Beard Description 

•b name sockets connectors Define a circuit board. Arguments are board name, the number of 
sockets on the board, and the number of I/O connectors. 

.be t+ I —1 rotation coord 

Board Orientation. A .bn command gives the orientation of the board relative to that used 
when the board is placed in a wire-wrap machine. A • indicates that the board description is 
with the pins pointing u* A > is used when the board is described from the component side. 
Coord is the boerd location of the wiring machine's origin and rotation is the number of right- 
angles by which the board must be routed anti-clockwise about the wiring machine's origin m 
order to bring the board into the Ant quadrant 

s name [pac ka g e) ... 

DeAne a s o ck e t type. Arguments are the socket type name and a list of the package types that 
can be located in the socket The first package listed should be that whose pin numbering is the 
same as is used on the socket 

.sb setof I socketno coord) 

Socket locations. One or more .sb commands following a .s command give the list of sockets 
mounted on the circuit board. Each socket has a number and board location. The socket 
numben must run consecutively from one. The position of a socket is that of the corner 
nearest to the board origin., .x name pms length width 

Define Input/Output Connector. Arguments are the name of the connector, the number of 
pmt and its overall dimensions. The length is the distance along the X axis and the width is tne 
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distance along the Y axis. Note: the pins for a connector should be numbered consecutive •. 
from one even if thtt means inventing a few extra pins. 

.xb coord 

Connector location. The coord is the board position of the connector. That is the position of 
the corner nearest to the board origin. 

xp setoffpmno coord] 

Connector pin positions. One or more .xp commands following a .x command gives the list of 
pins and their coordinates relative to the position of the connector. 

.t number name 

Define special signal. The special signals are numbered consecutively from zero The argu- 
ments for a .v are the special signal number and the signal name to which it corresponds. 

.rb setof {pinno coord] 

Special signal pin positions. One or more .»b commands following a .r command give the - 1S t 
of pins and their positions on the circuit board. The pins should be numbered consecutively 
from one. 

Chip Type Descriptive 

•t norm package [ptnno] ... | .t name m ypt 

Define a chip type. Argumenu are the chip type norm, the name of the package in which it s 
installed, and pm numbers, pinno. for the special voltage connections. The special voltage pm 
numbers can be omitted if none are to be wired but if any are present they must be in the same 
sequence with which the special signals are numbered. (See .? command above.) A .t com- 
mand can be used to give an alternate name to a chip type. In that case the alternate ram 
should be followed by equals and then the already defined type name. 

.to [pmno\ ... 

Chip output pins. One or more .te commands following a .t command give the numbers at 
pins that carry output signals from the chip. 

Circuit Descriptive 

name Stan a module. The module 

is given as argument All unqualified chip and signal names (no '/') m subsequent text ar 
presumed to belong to this module. 

» paftfto 

Stan a page. The page number is pagena. ^ 
x name [typel | .c name m chip 

Describe a chip. If the chip has been previously described one can give just one argument, m 
chip name. Otherwise one must give the chip name and chip type, or the chip name and 
name of a previously d es cri b e d chip. In the latter case the two chips will be treated as one. S g 
nai descriptions following a .c command refer to pins on the chip. 

.e{fc | si tockemo 

Chip placement Saekeme is the number of the socket into which the chip described m a prev. 
ous .c command is to be placed. A hard placement, specified by .ch. will not be changed r 
automatic placement programs whereas a soft placement, specified by .cs. will, a placemen 
specified by a .cu command is a dummy that is used to deaenbe chip grouping only In a. 
cases, chips assigned to the same sockemo occupy a single package. 

.i name 

Circuit board inputs. The connector name is given as argument. Signal Ascriptions follow - 
this command refer to signals originating outside the circuit board and the pin numoers . 
connector pin numbers. 
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• 0 name 

Circuit bond 1 output. The connector come is liven as anutnent. S„nal dcsenotions follow, ns 
TS ZS IF " cire “'‘ *•« «« ">« numwrs arc con«c 

• h s/g/w/ 

wir?n| p'roVram. 011 ^ “ '** "*"* ° f 1 ! “ nal ,h “ » '»■»«< * an automatic 


Un-fl* chip positions. Chip positions deAncd with previous .eh. .« or .ca commends w.ii hnu. 
no effect on the placement. However, grouping of chips will remain unchanged. 
q 

End of Ale. Not usually necessary. 

SEE ALSO 

draw(l). wcheck(l). wrapd). placed), bdrawd) 


i 
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The following characters may be used in addition to the letter which selects the function 

desired. 

c The current directory in the file store is specified in the first name argument. 

The FS has the same working directory as the user has on UNIX. 

y Set verbose mode. Normally nfs does its work silently. The r option causes it to 

type the name of each file it treats preceded by the function letter. 

I Set interactive mode. In this mode nfs pauses before treating each file, types the 

indicative letter and the file name, and awaits the user's response. Response y 
means yes', so the file is treated. Null response means 'no', and the file does not 
take part in whatever is being done. Response x means 'exit’: the nfs command ter- 
minates immediately. 

x Set explicit mode. In this mode directory names denote the directories and not their 

contents (as is normal). 

T Temporary files are created. This option is used for files which are transient on the 

FS and do not need tape backup. 

B Large Ales have their space allocated in tracks. 

FILES 

/dev/tiu 

see ALSO 

ufs(l) 


7th Edition 



37 v8 


DCON ( l ) 


Eighth Edition 


DCOlSMi) 


NAME 

dcon. ndcon, rx. rogin. rsh — remote login and execution 
SYNOPSIS 

dcon [ option 1 ... machine 

ndcon machine 

rx machine ( command-list ] 

/uer/bia/a/machine ( command-list 1 
/usr/inet/bia/rogia machine [ *1 username 1 
/uw/iiiet/bia/rsh machine [ -I username 1 ( command-list 1 
DESCRIPTION 

Dcon logs in to the computer whose Datakit address is machine. It is much like cud), but the only 
local escapes are hang up ‘V and a shell escape *T. 

Dcon normally tries to log in automatically, using the login id of the invoking user. To logm expli« 
citiy. or to connect to machines that disallow such access, use option -I. Other options are: 

*v Verbose. Give play-by-play while logging in. 

-s Script. The machine argument names a file that guides login. The first line of the file is 
the machine name. Later lines are paired: a prompt word expected from the remote 
machine (including nonblank punctuation), with an input line to send upon receiving that 
prompt. All other words received while looking for prompts are ignored. 

Ndcon logs in to a remote computer similarly to dcon. but with a direct stream (4)-to-stream con- 
nection. In particular mux (9) layers may be downloaded across it. The only local escape is the 
quit signal (controlA). Legitimate answers to the subsequent prompt % dcon>>' are T [sic! to send 
the quit signal to the remote machine, *x’ or V to exit ndcon . and "command-list' to execute com- 
mands locally. 

Rx invokes a shell on the designated machine and passes the command-list to that shell The stan- 
dard input and output of the remote process are the standard input and output of rx The standard 
error file from the remote process is the same as the standard output. The current directory, per- 
missions and shell variables of the remote shell are what the user would get by logging in directly 
Unquoted shell metacharacters are interpreted locally; quoted ones are interpreted on the remote 
machine. 

Rx with no commani*Ust is equivalent to 'dcon machine*. 

Directory /usrlbin/m contains machine names as commands: 7usr/btn/m/machinc’ with no argu- 
ment gets an ndcon connection; with arguments it does rx. If the directory is in the ;A(l) search 
path, the names become commands for navigating the local cluster. 

Rofim and nh are to aRPA internet as dcon and rx are to Datakit. A file ' rhosts’ in the login 
directory for username on a receiving machine lists machine/user pairs that may log in as username 
without a pamword check. Pairs appear one per line separated by blanks. 

EXAMPLES 

rx ov er t here eat filel > filc2 

copies remote filel to local file2: for other ways to do the job, see pujA(l) and nfs(5 ) 

rx overthere cat filel ">* fi!e2 

copies remo ia file i to remote file2 

FILES 

/usr/inet/lib/* 

/usr/inet/lib/hosu.equiv list of machines with identical users 
SHOME/ rhosts 
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NAME 

SYNOPSIS 

DESCRIPTION 


PILES 
SEE ALSO 
DIAGNOSTICS 


tss — interface to Honeywell TSS 
t as 

tss will cell the Konevwell 6070 on the 201 data 
Dhone. It will then go Into dlreet access with 
TSS. Out out generated by TSS Is typed on the 
standard outout and Input requested by TSS Is 
read from the standard inout with UNIX typing 
conventions. 

An_ Interrupt signal (ASCII DEL) Is transmitted as 
a break to TSS. 

Inout lines beginning with are Interoreted as 
UNIX commands. Inout lines'beginnlng with ~ are 
lntsrorstsd as commands to the interface routine. 

~<file insert input from named UNIX fils 

“>fil« deliver tss outout to named UNIX file 

~p pop the outout file 

~q disconnect from tss (quit) 

“r file receive from HIS routine CSR/DACCOPY 

~s file send file to HIS routine CSR/DACCOPY 

Ascii files may be most effieientlv transmitted 
using the HIS routine CSR/DACCOPY in this 
fashion. Underlined text eomes from TSS. 

APTname is the 6070 file to be dealt with. 

SYSTEM? CSR/DACCOPY (s) APTname 
Send Encoded Pile "s file 

SYSTEM ? CSR/DACCOPY (r) APTname 
Receive Encoded Pile ~r file 

/dev/dnO, /dev/doO 


DONE when communication is broken. 


RUGS 

OWNER 


When diagnostic problems oceur, tss exits rather 
abruotly. 

csr 
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NAME 

nfs — communicate with Spider File Store 

SYNOPSIS 

nfs —key i name ... 1 

DESCRIPTION 

V/j saves and restores selected portions of the file system hierarchy in the Spider Fi: 
Store(FS). Its actions are controlled by the key argument. The key is a string of character 
preceded by *-’ and containing at most one function letter and possibly one or more functio 
modifiers. Other arguments to the command are file or directory names specifying which file 
are to be transfered. or listed. If no name is given. is the default. 

The name arguments serve a dual role when a file is being transfered between UNIX an 
FS. In UNIX they are interpreted as usual with respect to the current directory, n :he 
Store, they are interpreted with respect to the user’s directory (as specified in the File 5 tor 
password list). Thus, if the user ‘abc’ has a FS login directory abc. the file names m the urge 
ment refer to files in the FS directory abc regardless of the current UNIX directors For exam- 
ple. if the user abc’s current working directory is /usr/hem/second and he invokes 

nfs -w x y 

the files x and y of /usr/hem/second are sent to the FS files /abc/x and /abc/y. 

If c is used the arguments are interpreted with respect to a named directory, if is used the F 
interprets the files names with respect to the current working UNIX directory. For example, 
abc's working directory is /usr/abc/sub/dir and he invokes 

nfs — w. xy 

the files are put on FS /abc/sub/dir/x and /abc/sub/dir/y. Without the V option they 
to the FS /abc/x and /abc/y. Normally, when a directory name is specified it denotes the cor 
tents of that directory. If x is used then the directory name denotes the directory itself. 

Each time that nfs is used the user is logged into the File Store and for this purpose his currer 
user name (login) under UNIX is used. 

The function portion of the key is specified by one of the following letters: 

w Write the indicated files and directories to the File Store. If files with the same name 
already exist, they are replaced. 

u Update the File Store, u is the same as w. but a file is replaced only if its modificatic 

date is later than the date stored in the File Store: i.e. if it has changed since it was u 
written there. 

4 Delete the named files and directories from the File Store. At least one name 
mem must be given. 

r Read the named files from the FS and write them into the UNIX file system. 

f List the titles of all items in the named directories. The complete tree is give: 

Names begining with *.* are not listed. If a file name is specified that name is tvpe 
back but only if the file exists in the FS. 

I List is the same as t but more information about each file and directory is given 

s The space allocation and amount of space used for the account associated wan ... 

named directory is given. 

ns Make a new directory in the FS. 
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NAME 

SYNOPSIS 

DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 


su 


su — become privileged user 
su password 

su allows one to . become the super-user, who has 
all sorts of marvelous powers, in order for su 
to do its magic, the user must pass as an argu- 
ment a password. If the password is correct, su 
will execute the shell with the UID set to that 
of the super-user. To restore normal UID 
privileges, type an end-of-file to the super-user 
shell . 


shell 

"Sorry" if password is wrong 


OWNEK 


dmr 0 ken 
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Eighth Edition 


SU (8) 


NAME 

ju - substitute UMT id temporarily 
SYNOPSIS 

/Ht/m [ mend 1 


DESCRIPTION 

££rys sr » - — - 

exc«pt for HOME and SHELL, which art taken • — i^Tr!nI^' l | U |ih • nv '™" mwM '* «*"el»n«ad 

»«Z?r T> ““ * b “ "*«■»«-. *. M 

SEE ALSO 

sh(l) 


* 


Pigt 1 


January 31. 1985 
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CRYPT (I) 
NAME 

SYNOPSIS 

DESCRIPTION 


PILES 
SEE ALSO 
DIAGNOSTICS 


10 / 23/71 


CRYPT (I) 


crypt — eneoda/doeedo 
crvot [ password ] 


£2125 if *n axact implamantation of Boris 

** ehln * e * u,d th * "- jo9 

cr YP < i r **^a fro* tha standard input fila and 
wr **** on tha standard output. For a givan pass* 
word t tha ancryptlon procass is idanpotant; that 
!•* 


crypt znorfcla <claar >cyphar 
crypt snorkla <cyphar 

will print tha elaar, 

crvvt la aultabla for usa as a flltart 

pr < "crypt bandarsnateh’<eyphar 


[1] U. S, patant 2,089,603. 


BUGS 
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CRYPT(6) 


NAME 

crypt, encrypt, decrypt - encode/decode 
v NOPSIS 

/usr /gases/ crypt [ password ) 

/uar/ganee/encrypt I -pl( password ) 

/uar/ganee/deerypt ( -p ) ( password j 
DESCRIPTION 

These commands read Tram the standard Input end write oa the standard output. The password is 
an enciphering key. If do password is given. oee is demanded from the terminal; echoing is turned 
off while it is being typed in. Crypt time a relatively simple, fast method (rotor machine) for both 
enciphering and deciphering. Encrypt and decrypt ase a more robust, slower method (DES). Filoe 
enciphered by crypt are compatible with these treated by the editor ed in encryption mode. Filer 
enciphered by crypt are not intelligible to encrypt/decrypt. and rice vena. 

It is prudent to supply the key from the terminal, ant from the command line, and to pick a reason* 
ably obscure and long key (6 letters for crypt and ranch (eager for encrypt). 

Under option -p encrypt enciphers into printing characters, which can he sent by maU (1). Decrypt 
can distinguish ciphertext from dear it will work oa a full maU massage, headers and all 

FILES 

/dew/tty for typed key 
SEE ALSO 

ed(l), make key (t) 

J. A. Reeds and P. J. Weinberger, ‘File Security and the Unix Crypt Command.' AT AT Bell 
Laboratories Technical Journal. 63 (1914) 1673*1614 

JOS 

.-'.Encipherment cannot frustrate adversaries with super user privileges. Cryptogames have other 
dangers too. The only useful application is ia data traaamistiea. 
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NAME 

number - convert Arabic numerals to English 
SYNOPSIS 

number 


DESCRIPTION 

'>« sund ardinput to the stands output. cnaniin, sacn docimal 
mrouirlwaa) Punctuation is added to maitt the output sound well 


number :o a 
when played 


SEE ALSO 

spealc(l) 


7th Edition 
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DSW 


t » 
V - 


NAME 

SYNOPSIS 

DESCRIPTION 


FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 

OWNER 


dsw — delete interactively 
dsw [ directory ] 

For each file in the given directory " if not 
specified) dsw types its^name. If y is typed, 
the file is deleted; if "x" , dsw exits; if any- 
thing else, the file is not removed. 


rra 

"?" 

The name "dsw" is a carryover from the ancient 
past. Its etymology is amusing but the name is 
nonetheless ill-advised. 

dmr, ken 
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DDi 1 1 


NAME 

dd — convert and copy a file 


SYNOPSIS 

dd [option— valuel ... 


description 

Dd copies its specified input file to its specified output with possible conversions. The input and 
output block size may be specified to take advantage of raw physical I/O. 


option 

if- 

of— 

ibs— 

obs— 

bs— 


cbs — « 
skip—* 
count—* 
conv— ascii 
ebcdic 
lease 

swab 

noerror 

sync 


values 

input file name standard input is default 
output file name standard output is default 
input block size (default 512) 
output block size (default 512) 

set both input and output block size supersedin« ibs and obs: also, if no conver- 
sion is specified, it is particularly efficient since no copy need be done 
conversion buffer size 
skip n input records before starting copy 
copy only n input records 
convert EBCDIC to ASCII 
convert ASCII to EBCDIC 
map aiphabetics to lower case 
map aiphabetics to upper case 
swap every pair of bytes 
do not stop processing on an error 
pad every input record to ibs 
several comma-separated conversions 


Where sizes are specified, a number of bytes is expected. A number may end with k. b or w to 
specify multiplication by 1024. 512. or 2 respectively. Also a pair of numbers may be separated 
by x to indicate a product 

Cbs is used only if ascii or ebcdic conversion is specified. In the former case cbs characters are 
placed into the conversion buffer, converted to ASCII, and trailing blanks trimmed and new-line 
added before sending the line to the output In the latter case ASCII characters are read into the 
conversion buffer, converted to EBCDIC, and blanks added to make up an output- record of size 
cbs. 


After completion, dd reports the number of whole and partial input and output blocks. 

For example, to read an EBCDIC tape blocked ten 80-byte EBCDIC card images per record into 
the ASCII Ale x: 

dd if-/dev/rmtO of-x ibe-100 cb s -10 conv— tsciiJcase 

Note the use of rev magtape. Dd is quite suited to I/O on the raw physical devices because u al- 
lows reeding and writing in arbitrary record sizes. 


SEC ALSO 

cpCD 


BUGS 

The ASCII/EBCDIC conversion tables are taken from the 256 character standard in the C ACM 
Nov. 1968. It is not clear how this relates to real life. 


- 1 • 
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faced ( 9.3) 


NAME 

ftcad — network feet server 

SYNOPSIS 

/uer/net/f ece . 90 

DESCRIPTION 

The network ftce server provides a database of 4|x4t bit icons aad other facial representations. It 
is implemented u a network Ale system similar to a#f/r(J). 

The Ale system, c onve n tio n ally mounted on /n/faco, has a Aaed thro o « l ev ml hierarchy. The Ant 
level is a machine name, the second level a user name, and the third level a resole bon. Thus the Ale 
/n/f ace/lcvee/p jw/4i*4S*l is the standard face icon (for user pjw) on machine kwee 

e 

Many local user* alao heve 512x512 byto high-resohetioe fsom, named 512x512x4. Other rmolu- 
tions may alio ba prtMat for a particular fact. On#- bit images art noted is tbc format oaod by 
iconO.l); eight-bit images an array* of bytax Tba di r ec tori e s for asebinoB abaring a osar ocm- 
munity, such u those oa a Detaldt node, an Hakad together and giraa a name appropriate to the 
community. For example, /n/f aee/kwee is a link to /a/faee/aetxo. 

To access the face for a mail name machiat I u id taka tba result of tba Am seceanftti open from the 
following list of files: 

/a/ftet/asehiM/oil/ilxilal 
/n/faco/alsa . /ald/4«x4«a 1 
/a/f aee/aachlna/naknow&/44x44x 1 

/n/f aca/aiac . /unknown/ 44x44x1 '* 

The directory alec. bolds faces for g eneric users such as root and map. Tbc face terror is made 
available oa a machine by running /usx/net/face . 90 from rc(l). 

Tba fact terror data is administered by a pair of ASCII film that associate related machines and 
facta. Tba machine tabic Machine . tab attaches machines to communities; in it the line 

kwcceaatre 

putt machine kvea in community astro. Tba people table people. tab associates a 
machine/ user pair in tba fact s erver with a file in one of the scene directories 
/ua»/ jarq/lcon/faea44 or /tO/faee/3 12x5 12x1 oa kwee. Thus 

astro/p jvepjsniaberper 

causae the imagea stand in sauna film earned pjvalabarvar to ba available la tba £eea server in 
directory /n/face/aatro/pjw. As weiL each disk (Ba used by the face server is linked (by its 
original same) into tba dir ec to ry /n/f ace/ 44x44x1 or /n/face/S 12x5 12x4 far easy access to 

all Urn imupa. 

FILES 

/n/kwue/u**/jarq/leaa/face44 
/n/kwea/tO/f aee/S 1 2x9 1 2x4 
/n/kwee/uar/net/f ace/ people . tab 
/n/kwee/uar/net/f aeo/aaehlae . tab 

SEE ALSO 

nttfs (8) , fact (9.1), muft (9.1), icon (9.1), virmo* (9.1) 

BUGS 

After updating the tables, an indttenninats time may pass before tbc new faces an available. 

All face server film an unwritable. 


directory of low naoiutioa fsen 
directory of high resolution facm 
people/ file equivalences 
machmt/eoBununity equivalences 


Page I 
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iNTftOOOCTIC* 


This 9 Ivm ccvpl«i« daicriptloni of «U lha publicly 

available (Miuiaa of util. It providai MUhac • ftnanl ovsr- 
vi«m (mi Tha UN1M Tin* -ahari «9 Syaiw for that) nor detaile ol 
aha i^laMniatioA of tha ays too | which raoa la to ho diaclosad). 

Within tha araa it survey a, thla oanual ettaopte to ha aa coo- 
plata and ttoaly aa poaalhla. 1 cooactoua daclaion was oada to 
daacnba aach pio^raa m aaactly tha atato It woo In at tha tina 
ita oanual aactlon wee prepared. in particular, tha daalra to 
daacriba something aa it ahould ha. not aa It la. waa raalatad. 
Inavitably, thla oaana that oany aactiooa will aooa ha out of 
data. (Tha rata of chan? a of tha ayatan la ao great that a 
dl eoayingly lar 9 a nuohar of aarly aactlona had to ha oodiflad 
dtila tha raat wara halnq wrlttan. Tha uohoundad affort required 
to at ay up-to-date la ha at indicatad hy tha fact that aavaral of 
tha prograoe daacr lhad wara wnttaa a pacifically to aid m 
pcaparatloo of thla oanual 1 1 

Thia oanual la dlvidad into aavan aactionat 


I . Coooanda 

I I. Syatao cal la 

III. Subroutine® 

IV. Special fllaa 
v. rila for oat a 

VI. Uaar-oaiotalnad prograoe 
vil. hlacallaoaoua 


CuMMndi ara prograoe intandad to ba invoked di racily by tha 
uiti, in contr adlatinct ion to aubroutlnaa. which ara intandad to 
ba cal lad by tha uaar'a prograoa. Coooanda generally raaida in 
dnactory /bin (for binary prograoa). Thla dtractory la aaarcl.cc 
auiGoatlcallyby tha coooand Una intarpratar. Sooa prograoa 
claaalfiad aa c coo and a ara locatad alaawharai thla fact la indi- 
catad in tha appr opr lata aactlona. 

iystam calls ara intnta into tha lac:* supervisor . |n agecably 
language. thay ara cod ad with tha uaa of tha opcoda ay a . a 
synonym for tha f f ao instruction. 

Tlo spacial fllaa ssction discuatn tha charactar i st lea ol each 
sy st co "file which actually refers to an 1/0 device. 

Tlo (lit: formats section documents the structure of particular 
Kinds ol files; (oi e-aople. •». foio ol the output ol the lo. dn 
end Ik given. bn, » are files used by only on. cn. - 

w*and. for enample the assembler's i nt cimediate files. 


Il:,i 
I » |i 
I I • 


n a i m a i ned | i 
an I the | I t n« 

I M jl I III l' W » 


(xii am s nr n* » considered pall of the IH I* s > 
i |4| icisui | i-i listing thee is * u iiulu at f 
Ibout fmriiui »l| giving a i «.<rpl el c 


description. The author should be consulted for inforoation. 
Tha olacallanaoua section gathers odds and ands. 


Each section consists of s number of independent entries of a 
pag# or so aach. Tha mat of tha antry la in the upper right 
corner of Its pages. Its preparation date in the upper left. 
Entries within each section are alphabetised. it was thouoht 
batter to avoid page nunbera. since it is hoped that the sanui l 
will be updated frequently. 

Ail entnee have a coaon format. 

The naaa section repeats the entry nane and gives a very 
short description of Its purpose. 

The pvnopala sumadies the use of the program being 
described. A few conventions are used, particularly in d.e 
Contends sac t ion i 


Underlined words ara considered literals, and are typed 
just as they appear. 

Square brackets ( ( ) ) around an argument indicate that tl.c^i 
fcgiMftfnt la optional. When an argument Is given as ^ 

Mat . It always rafara to a file nane. < 

ellipses are used to show that the previous 

ergunent- prototype nay be repeated. 

A final convertion is used by the commands,. their se i vei . 

An argument beginning with s ninus sign is often tar 

an to nean son# sort of flag argunent even if it qpjii 
in a position whara a file nane could appear. Therefore, 
it is unwise to have files whose names begin with 

Xm i^ion section discusses in detail the subject a i 

hand. 


The 1 1 lss section gives the names of files which ate burn 
into tha progiee. 

A sea ^1 so saction gives pointers to related inlomduui.. 

A diagnostics section discusses the diagnostics that n.a > 
produced? This section tends to be as terse as the do,., 
ties thenselves. 

The bugs section gives Known bugs and somet imes dtln 
cies. Occasionally also the suggested fi« is describe.*. 


The owner section gives the name of the person or , s, 
be consulted in case of difficulty. The rule has be*,, 
the lest one to modify something owns it. so the own., 
not necessarily the autlior. The owner s initials s.a, . 


i i i 


hen ft. IhiMpMn 

dir P. ft. litchlt 

jfo j. r. oeeeane 

rift P. IPirU 


ThtM thrM-chAraa me a ernes dso h*w<n to b« Unix uatr 
ID'i, fto MM* 9 «i mv bft IIMMiltii by (hi Mil coafttnd or. 

If lift xPUiMM Aft IftfpftP U« by 


I . COMMANDS 


TABLE Of CONTENTS 




At thi bt«U«U« of thlft dftCMftftftt Aft ft tftblft o t conlwti, organ- 
ised by iftct A om Md alphabetically wltbia ftacb ••Ctloi. Thwa is 
Also • fsrsulid Udai derlvftd from tbft tftblft of oootftftts. Within 
•Ach lndft« ftatry, tbft tAtlft of tbft srltsiy to which It r«(«ri I a 
follow Ad by tbft ftpptopr Ifttft ftftctAfto owobot Ao parentheses. This 
f Act Aft IftpoftftMt bftCAuAft tbftrft Aft oomatdftrftblft sftft dual IcAt ion 
aam| tbft ftftctAooft # fti A a Any prAocApftlly from no— in ds which eeist 
only to ftMorciftft • particular ftyfttoo coll. 


Thlft oftftwftl waft prftperftd uftlsf tbft UNIX tftat editor f} And ths 
format t lop progrem foli . 


A t 

AA 

b ;;;;;;; 

bAS 

bed 

boot !.!!! 

CAt | ( 

chdir 

check 

chmod 

chown 



C P 

dAtA 

db 



dc 

df 

diw 

dtf 

du 

Ad 

find 

for 

fora 

hup 

*N>f» 

Id . 

In 

Is 

PAI I 

OAA 9 

mkdlr 

mkf s 

mount 

AV . 



od 

P* 

row 



rkf 

rki 

re 

rndu 

voff 

AdAtA 

Ah 

A t A t 

strip 

AU 


Archive (coAbint) files 

Assembler 

coop! Is B piogr a* 

BASIC dislsct 
convert ASCII to BCD 
r a boot systso 

concstsnAt a (or print) file* 

• Chengs working dirsctoiy 
chock consistency of file system 
Chengs Access »ode of files 
Chengs owner of files 
coppers file contents 
copy file 

9At dels end tip# of dey 
sypbolic debugger 
write binery peper tepe 
desk celculetor 
find free disk spec# 
delete flies interect ively 
forpet DECtepe 
find disk ueege 
tejct editor 

find file with given neM 
compile For t r An prog iaa 
generete forp letter 
heng up typewi iter 
reed binery peper tepe 
link editor (loeder) 
link to file 

list contents of directory 
send aa i 1 to Another user 
perpit or deny aesseges 
ciiomo directory 
Initiellse file system 
mount detechebie file system 
move or reneae file 
print neaellst 
octel dump of file 
print file with heeding* 
rewind DECtepe 
dump disk to tepe 
foraet UK disk 
loed disk from tepe 
rsaove (delete) file 
remove (delete) diiectoiy 
run off (foraet) test 
Adjust dete And time 
commend interpreter 
git file AtAtus 

remove symbols, relocation iii 
become super -user 
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tty . . 

typ« . 
umunt 
uo . . . 

WC . • • 

who . . 


sum $ i I© 

««nipuUi* DECup« 

9 * t UM inlorMtton 

•••••• fi »4 mm of t«(Bin«l 

111 # on Ibh 2741 

VMOv«bl« file 6 y. le «* 

undefined tyaboii 

CO a (l»|!lih) wo rd count 

•••••• Is os t&to lyittft 

• ••••• mt I ts to ssothsr uui 


II. SYSTEH CALLS 

ti««K . . . . ; 

etui 

chdir 

ctsod 

chown 

doit 

CIMt 


SMlt . 
for A . 
Iitit 
qetuid 
«tty . 
U 9 IM 
int r . 
link . 
•Adi r 
mount 
opsn . 
quit . 
rtid . 
itlt . 
ftttk . 
setuld 
irdrtt 
slat 

fttlM 
•tty . 
tsll . 
UM . 


uni ink 
wm . 
writs 


sst proqr am break 

cstch Ur traps 

chsoqs wockinq dirsetory 

chsnqs sods of fils 

chenqs ownsr of fils 

closs opsn fils 

erssts fils 

sn scuts proqram fils 

tsrolnsts snscution 

erssts new procsss 

ststus of opsn fils 

qe t ussr ID 

qst typewriter node 

cstch illsqel instruction trap 

cstch or Inhibit Intsr rapes 

link to fils 

erssts dirsetory 

©o an a fils systso 

opsn fils 

cstch or inhibit quits 
rssd fils 
rslssss procsssor 
oows rssd or writs pointer 
sst ussr ID 

sst dsts codified of fils 
qst fils ststus 
•st system tins 
sst code of typewriter 
find rssd or writs pointer 
qst ties of yssr 
discount fils system 
rssovs (deists) fils 
unit for process 
writs fils 


111. SUBROUTINE S 


not n>nv«M ASCII to f lost m*» 

stoi As* I I IU »*••*•• 

Cl IM • IM M» • ll 

Ci^ ••^-^•**•••1 • • • «-• 


fptrsp .. 
ft o <3 .... 

qst 

1 1 os . . . . 

loq 

siS 9 . . . . 
ptins ... 
putc .... 

• In 

•witch .. 


f 1 ost Inq- poi nt kinuidtor 

convert flostlnq to ASCII 

qst character 

convert inteqer to ASCII 

loqanthm hens e 

print str inq on typewriter 

print tins 

writs chsrsctsr or word 
sine, cosine 

transfer dspsndinq on vilut 


IV. 

SPECIAL FILES 



me® . 




ppl . 
rfO . 



. penciled prper taps 
RF di ak file 

rkO . 



. RK disk file 

tapO. 
tty • 

• •••**! ?"> 


. DEC tap® file 
• console typewriter 

tt yO, 

. ...ttyS 


• remote typewriter 


V. FILE FORMATS 


A. out assembler end loader oui(.ui 

Archive Archive file vj 

bppt Linsiy psper tape foimut <o 

cere core imqi file 

directory directory format 

fils system filo format 

pssswd password file 

uids nAMfi to user IL»'s 

utnp loqqsd-in user informal ioi, 


VI. USER MAINTAINED PROGRAMS 


Uuc DEC supplied bid 1C 

|>j the qam* of hlsck jack 

ca| print ca lender 

chess (h« 9 a me of dies* 

ass disaisseihler 

dH load DEC binary paper tajes 

dpt !!!..!...! read DEC ASCII paper tape:. 

the qa*e of «oo 

sort !!!.!!..! ‘ oci * f»** 

u( the «jame of lic-tac-toe 


VII. MISCELLANEOUS 
a s2 

ASCII 

ta 

be 


a%!*eniCl«i 'e |.at.s 2 

m p of AtC I I 
t i^emLUt 
b cce pi let 




» 


Li I fib B inu-i, 

bprce )( boot ^loctduiv 

Utf,brt2 ft start And (inuh 

M,l2 t U t (4 Fortran compiler passes 

glob •f9UA«nt wpAndtr 

inlt initialitftff oroctu 

kbd Mp of VTV )i kiybofiid 

libs lUidtfd •••t»bly-Un9u4Q« library 

llbb |Uid«N ft 1 lbs ary 

1 ib( Ilialird Fortran library 

login, logout logging on and logging oil the sy = u.i 

®eh oini ftfcftil 

§uf ( Ab «#..••*.*••••.*..«.... f®l I ft flttf 1 S *t t Abl O 

tab# Hi tftfc ftiopt on lypdwutu 


lNDt* 


ctiROd 111: chfinqt; 

•dated ) s 
nail(Il: a«nd Mil to 

write! Id write to 
arl I d 

Archive! V) ; 

glob(VU): 

dpt I VI ) : read DEC 
bcd( 1 ) ; convert 
etofUU); convert 
etoil 111 I: convert 
eeciilvil); nep of 
ct ined II d convert tine to 
convert floating to 
fitoei III); convert integer to 


A. out! V) i 
Aril); 
bat VI 1 ) : B 
as2l VI 1 1: 
libai VI 1 l ; etAndard 


bat VI 1 ) : 
bc(VU): 
hi lib( VI I ) : 
liLt I VI 1) : standard 
bll): coepile 
br 1 1 . trt2l V] 1 1 : 
iogdlllt logArlthn 

bait 1 ) : 

beeicl VII: PEC euppded 


bed! Id convert ASCII to 


• u( I l ; 


bppt t V I : 

dbppt III: M * ll * 

Ibpot(l): l*« d 
dl fi ( VI ) ; load UtC 
remove symbols, relocation 


access node ofi files 
adjust date and tine 
another user 
another user 

A.outfVl: assembler and ioadei oui| u« 
Archive (combine) files 
archive file 

Archive! V): Archive tile 

Argument enpander 

Ar(l) i Archive IcomLinel tiles 

ASCII peper tapes 

ASCII to bCU 

ASCII to floating 

ASCII to integer 

ASCII 

ASCII 

ASCII...! toall III; 

ASCII 

ascii! VI 1): eisp ot ASCII 
esld: Assembler 
assembler end loaoer output 

Assembler 

assembler 

assembler's (x-ss 2 
assembl y- language library 
as2|Vll); assembler's pass 2 
stofllld: convert ASCII to | loot mg 
atoll 1 11): convert ASCII to integer 
B assembler 
B compiler 

B interpreter library 
B library 
B program 

B start and finish 
base e 

bas! ll: BASIC dialect 

BASIC dialect 

BASIC 

basiclvil: UtC supplied BA1 1c 
balVlll: b assembler 

BCD 

bed! II : convert ASCII to kre'b 

be! VI ll: b compiler 

become super -user 

bill: campi le B program 

bilib(Vll): b interpreter libiuiy 

binary paper tape toi rut 
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PREFACE 

to th# Sncond edition 


In thA aonths since this srnurl first appeared, asny changes hsvs 
occur rsd both In ths systa- ltsalf And in ths way it is usad. 


Perhaps -oat obviously, thara hava baan additions, dsistlons, and 
wkdif lc at ions to tha systa- and its software. It is thasa 
eh s a g as, of course, that caussd tha appaaraoca of this ravisad 


A a co nd, tha »«bar of paopla spandlng an appraclabla Mount of 
lisa writing (Mil soft war a has incraasad. Credit is due to 
L. L. Cherry, M. 0. Mcllroy, L. B. McMahon, I. Morris, and 
J. C. Oss anna for thair contributions. 


Finally, tha nun bar of UNIX installations has grown to 10, with 
-ora asp set ad. Mona of thasa has saactly tha sane oonplsnant of 
hardware or software. Thar afore, at any part Icul ar Inst all at ion, 
it is guita possible that this annual will give inappropriate 
inf or-at ion. One area to watch concerns ooaaanda which deal with 
special files (I/O devices). Another is places which talk about 
such things as absolute core locations which are likely to vary 
with thena-ory oonf iguration and eaistence of protection 
hardware. Also, not all installations have tha latest versions 
of all tha software. In particular, ths assanblar and loader 
hava Just undergone -ajor reorganisations in anticipation of a 
mu for tha FDF-H/4S. 
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PREFACE 

to ths third Edition 


in ths non ths sines ths lost sppesrsnes of this ssnusl ssny 

£*"■•? *• ° ccuxr * <i b ° th in «» u..« rsrri*ihi 2 


U weed. »yRtss Itssic snd in ths way it 

f *^?* *? M ll *« hawa baan addition*, da la t Iona, and 

aodlf lcatloaa to tha syatan and tta aoftueta. it i s thaaa 

°* ««•*••. «h«* caoaad the appaa.aac* of thta tawl.ad 

■?*"■*•**• ot paopla a ponding an appraclabl* aaount ot 

tias writing UNIX software hss incrssssd. Crsdlt is dus to 
L« L. Cherry, N. 0. Mcllroy, L. h cits ho n, Morris, 

Oaseaee, nnd S* X* Flssos for thslr contr! hut ions* 

Fleelly, ths sushsr of UNIX Instsilstioss hss grown to 16, with 
aoro ongsetod. Moss of thsss hss sssctly ths ssss coapleaent of 
hs rdws is or software. Therefore, st asy psrtlcuisr installation. 
U id gulls possihU thst this assasi will give inspproprlsts 
isforastloso 

In psrtlcuisr. fay AXAlM “hich ossa s PDF-M/IQ orocsssor will 


dnnidon additions, deletions, snd aodlf lest ions to ths writsups 
in snch s action, thin annual dlffsrn froa its prodscsssors in two 
•ays i nil ths coaasads unnd for oyntoa asintonsneo snd not ln- 
tondod for aoraol uyere haws boon aovej to s now s set ion vi n j 
and thscs lo n nou How to Got dtsrtsd chsptor thst glass sows 
oloaoatnry fsets and assy polntnrs to othor s set loss , 
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INTRODUCTION ID til IS NANUAL 


This MiHial «!¥•• dtKrlptloM of Utt publicly »valUI>J« ftaturat 
of mux. It provides neither s |«ami overview less Tbs UNIX 
Tlme-eherieq tv st so for list) ssr 4s toils of tbs Ispleeeetetlon 
of the systss (which rsssls to bs disclosed). 

Within ths srss It surveys, tbls menus! Attempts to bs ss cou- 
plets sod timely ss possible. A ooss clo us dec 1 sloe use sods to 
describe eech proyrss Is sasctly tbs state tt use is st tbs ties 
Its eeeubl sectloe use preps red. Is pe rt lewis r 9 tbs desire to 
describe somethin* ss it should be, sot ss It le 9 use resisted. 
Isevitebly. tbls esses thet msny sectless ulll sees bs out of 
dste. | Tbs rets of ebssfs of tbs systss Is ss frost thet s 
dleeeylof ly Isrpe eusbsr of eerly sect loss bed to be eodlfled 
Oils tbs rest sere belef urlttes. The uebousded effort required 
to stsy up-to-dste is best Untested by tbs feet tbst several of 
tbs process described were urlttes specifically to old Is 
preperetloe of tbls eeauell ) 

This eeeusl Is divided leto elfbt eectloeei 

i CoMAnde 

II. Systss cdlls 

HI. Subrout lees 

IV. flpeclel files 

V. fils forests 

VI. ueer-eeleteleod prof csss 

VII. siecellssoous 

VI II. Mslstsessc^ 

CowmimU .to BiOftiM Int.toto to bo lovoRto dlr.ctly by th. 

I. coatrUIMMctko* to mUoutlMt, which totototo to 
k. cttl«4 by tit. tiMl't CotMnit .MOt.lly to.lto 

dUtctorv /bi. I tor blarv pro. Tb». lUtcMiy I. ...debto 
ato£.?to.lfyly th. «5-bto l tot.rpr.t.r. to— , 

clas.lflto aa co I. or. locatto thl. Itct to itoi- 

ctttd t. th. ttctlott. 

Swat., calla or. ahtrlaa Into tho UM1I auoarviaor. J« ogaoobly 
u££«. U.y ... ctoto with th. of th. opcoAo .y. . • 
ayaoayw tor th. UU iMtwctloa. 

a iwll aaaortoaat o» aubroutlnaa la avallablaj thay ara 
tol“lUto. actio. III. Th. binary tor. of ~>.t of tha. I. 
napt to tho ayata. library /Itb/itba.a. 

Th. apaclal S ‘ ‘ °‘ 

UtC davtca nawa. for th. hatowara. mat. to of th. «... of th. 
apscisl file* theee*lves. 


l » i 


The fils fomtti section V docuMnt. » 

— . tor a^pu’th. aaaoahlar% ^ 

-oe lets Ined Pfoorcsc (aactiAA ui t ... 
the UNIX evstmm sad ik. « : on * ir# °°t coneideced pert of 

22£Z& u j?2x: 5X.:r.“ 

oaacriptlo.. Tha author ahowU ba conaultto for Intonation. 

Tk. aiacallaaaoua .action (vil) ,.thar. odd. attd 

tho*ordlaarv waaT**?.*.^"^" 1 * “|l* ch “ r * not mtandto for uaa by 
tto. to ChlL. b! t. 4 L '?•*• k * c *“*" th *T dlacloaa Infonta- 

Thi^o!!fnL^!rT? L"l* ‘"taraatto. .mi in o that a 
neceuse they perform privileged functions. 


Cech section consists of s nuebsr of Indepsndent entries of « 
to., or ao aach. Th. naaa of th. antry iS^to tto Xto? cojnlr. 
of Its pSfSS 9 its prspsrstios dste is Ihe uppsr middle. Entries 
wltbls eech section ere elph.faeti.ed. The p£g. nuefae^ of elch 
•J* 1 ^ 11 *• ^ ••rlier hope for frequent, pertiel up- 

***** °* JJ* naans 1 ie cleerly is vsis, but is eny event it is 
liRA^hle.)* ** “ l * 4 * 1 * c **** c ***"» W nuebsrlng in . document 

Ail sstries he vs s comm forest. 

The files sectloe repeats ths entry mm and fives e very 
short doecriptioe of its purpose. 

The pynposif eueeerlcs. the use of the program being 
described. 1 few cos vent ion. ere u.ed, particularly in the 

Cn— nds sectloe i 

Underlined word, are cone lde red literals, end ere typed 

|ust ss they appear. 

Square bracket. (()) .round an argument Indicate thet the 
grgumgst is optioeal. When an argument le given ea 
name , it always refers to a file name. 

Kllipeee are used to ehou that tha previous 

argument -prototype nay be repeated. 

A final convention la used by the c o— ands^thsmsel ve«. 

An argument beginning with e minus a ign **-" is often tak- 
en to meen some eort of flag argument even If u appears 
in e position where a file name could appear. Thejefora 
it la unwise to have files whose names begin with - . 

The deecr lot Ion section discusses in detail the subject st 
hand . 

The f lies section givss ths names of filss which «r« UjHi 


lv 
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Into ih» program. 

A tit tilfi •action polftltii to ralated information. 

I limatlAy noctlon tflaoiMtc tin diagnostics that nay la 
protocol. Tbla aoctloo tooto to to aa tovoo •• tto dlagnoa- 
tlco tbmmomlvwo. 

Tto toga aoctloo gives Immo toga ani a o n a t loo a def iciea- 
ciaa. Occaalonally a loo tto anggaatol fit la described. 

previous edition of tbla manual tod an owmmf aoctloo. wblcb baa 
toon dropped from tbla edition because tto owmere* of many 
rout I no a becaoe fairly bard to pin doon. tto on Jar contributor a 
to UblX. (cast In order of appearance I together with ttolr login 
naoea and ooat notable cent r I tot Iona, ace 

ten X . Tboopeon 
tor D. M. aitcbie 

|fo J. r. Oaaaana 

doug M. 0. ncllroy 

rto a. Norrla 
loo t. I. nenaban 

lie L. L« C berry 

car C. 8. Bo tort a 

•to to a. riaaoa 

at tto tog Inn lag of tbla document la a table of contanta. organ- 
Und by a act Ion and alphabetically within each noctlon. There la 
alao a pe mated Into* derived free the table of cootoote. within 
each index entry, tto tit la of tto writeup to wblcb It refora la 
followed by tto appropriate aectloe auotor In pareettoaea. Tbla 
fact la leportant tocawao tto re la coneldorablo nano topi Icat Ion 
owing tto nnctlone, arlolao principally froo ooooande wblcb aalat 
only to o ware loo a particular ayatao coll. 


Thla oanuel wee prepared uelng tto UWIX teat editor £) and tto 
foroattlng prog ran fott . 

Tto • eel stance of 8. norrla la gratafuliy acknowledged. 


(Unix, oeny coooaede ) 

isi.'ssr' “• “• “ 

I tog. od} 

1 4c. nucb of library) 
cref) 

(fore. fad. oalloc) 

Itaa) 

(proof) 


BOW TO GET STAftTED 

Tbla section provides tto basic infoneetion you need to get 
■tart ad oa UWlXi how to log In and log out. how to conounicete 
through your terminal, and how to run e program. 

UMMiBB ll 

You oust call UNIX froo an appropriate terminal. UNIX supports 
WCII terminate typified by the TTY )7. the GB Teminet 300. the 
Meoorea 1240. and various graphicel UielMle on the one hand, 
and IBM 2741 -type terminals on the other. 

To use UNIX, you oust have a valid UNIX user nans, which nay to 
obtained, together with the telephone number, from the system 
administrators. 

Tto same telephone number serves terminals operating at all the 

eternised spends. After a data connection is established, the 
login procodura dnpenda on what kind of terminal you are using. 

2ZX 12 tcmioal 

UNIX will typo out "logini "j you respond with your user 
name, from tto TTY 37 torwlnaft. end any other which has the 
new-line* function (combined cerrlege^return egd ilne(eed). 
terminate e|cb line you type with tto new line key ( not 
tto return key). 


Such terminals include the GE Teiminet 300. moat display 
terminal®. Irectgort, TI. and certain Anderson -Jacobson ter- 
minals. These terminals gage rally have e speed switch which 
should be set et 300 (or 30 for 30 ctorectere per 
second) end a ha If /full duplex awitch which ahould be set at 
full -duplex. (Mote that this switch will oftee have to to 
c to need since NB-T8S requires half-duplex) . whan e connec- 
tion with UNIX Is established, a faw garbage characters ere 
typed (the login message et tto wrong speed). Depress the 
S break* keys this is e speed- Independeet eigne I a to UNIX_that 
a 300 - bn ud terminal is In use. UNIX will type logins at 
the correct epeed| you type your user name, followed by tto 
*return* key. Henceforth, the return . new line . or 
* linefeed* keys will give exactly the same results. Each 
lino must to terminated with one of theee fceyei no one ia 
listening to you until the return is received. 


fre tactile HlEtoalf 

From an I BN 2141 or the Ande* •on-Jacob.on Selectrlc teimi- 
**1 no maaaaga will appear, ktfi the data connection ia 
• •cabllahad. praaa the return key. UNIX ahould type 
° log In i aa daacrltod above. If the greeting doss not 
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I 


ApftCSf t(ltf A ftM ••OOMlt* IlilftPll |||* * » ufr u -i », -i* . 

*»>—i t 2£L s§ 

"* “* “* M*U| MNklil kH ,oJ • 

for .11 IIwm UniMli, U a® i^itM that you typo you * MM 

Mii'umtk!! S!l!!! > utii!fi ,,w *"• *'*•' *•» »•**•«. umii 

«^uai U.MI.U au Pu » o < a .^ r ^paT!SU*uin^"trro^“* I ‘ 

~srs: sisv 

«®®erltotf tot®, uaiot Wu ru. a preiHi-. “ t# 

for u oto tafo mattow. couault |Mty|ni) tklck 4 (kum«i tha 
£l*C» HCT^* *“•“• *** 4 **«*». <*M> <tWMNt typo- 

uhui am 

nmw •« Uric ways to log outi 

Vim cam a imply kAAf up tho ptoM. Hanging op to lift if you 

• w *?*•!• lhil l# . ** M»U Mi Joot lypM 

Ito proapt ilfMi I • It to a loo aafa if you ara to la. 
teractive ayetam pitfraaa, for ameple tha Mlur. it ta 
oooate If poo ovo enacutleg a noe> Interact I «u program, or 
ooo of your out profreee. Mick either 4ooa oot root tho 
typowltor or Ipoiti tha ond-of-flle Indication# which will 
roauit froo Maflap op. tho roaooo to that (MIX. oallka 
ooot ayatooo. 4 aaa aot terminate o propria aloply hocaoaa it 


too caa I of oot M typing ao ond-of-flle laCicatioa (ior 
character, ooot (O I I ) to tho Shall, tho Shall oil! tai 
oiaato ooi tho iofiai oooao«o will appear again. 

too caa aioo ioy ia directly aa a aot her oeer by plviap a 
lofia cn aoaaC < Bogie III). 


Whan you typo to UNIX. a 9 no*# deep ia tha ayatao ia gathering 
your character# a ad sawing tha* ia a aacrat place. Tha charac- 
tar# Mill not ha plvii to a program uatll you typa a return, as 
described above la Looping la . 

UNIX typewriter I/O la full-duplea (encept for Selectclc ternl- 
nala). It has foil r a ad -ah# #4, Mhlct a#### that you caa typa at 
oy tl*#. •*• Mhll# a pfogree ft# typing at y#u. Of comim, If 
you typa during output , tha au« put «lll aa«# tha Input cha«#< «#i 
Interspe road. Koaaai , whatever pau l f pa • ft • I ha aaaad up and 
inteipreted In cocract #ap«t* a , 

Thai# la # I ft*i 1 to 1 ha aa*u*t «*f «aaa »uM, aut ft « 1 a 


• • ft 


Mpot chase eta ra. am start! echoi^T**#*^ V “ ,u>|> ® echoing 
•hfooat character! hi*. ham^J^a^J? * ^ t ® Uio «» * uk ^ 


all tha char- 

etagle lloa tla* .k! k •iftakne can ba rapairad on a 

sTSctT—- ■•••- v- 


ITSgil^i I h!!t*i‘!l^*;U™." rUbOUt * ) ch *‘* c ‘»' »• not PMaa. to 
program# aot Inataad 9 ana rata# aa lot a r rum a ion* 1 . . 1 

£~»ny cu... lAauui pro ® imm tSTt^ki^io 

“ •“** * lo ?* that you don't want . 

•**•*?■• CM #rfli l* a I tha r to 1 9 nor a thia algnal alto- 

UMtUl*' fho^T^r 11 ^ ‘f <»aataaa of bain® t.r- 

ia II? catcha# latarrupta and stops 

****** ** • , knataad of terminating, ao that an Intarrupt 

^ “f*,*® *•** ** c^ilor printout uithoot losing tha Cila 

Being ad i tod ® 


*j|U Jlfhhl ia generated by typing tha ASCII rs character. 
It not Only caueee a roaming pro 9 rao to taroinata hut also 9 an- 
« iU * • file with tha ©ora loaf# of tha taro in# tad process* 
felt la useful for da 1099109 . 


Soaldaa adapt 1 09 to tha apaad of tha terminal, UNIX tries to ba 
lata 1 1 ipa at about uhathar you have a taroinai with tha no* lin#* 
function or uhathar It oust ha simulated uith carrla 9 a-raturn and 
Una-had, In tha lattar case. all laput carriage raturna ace 
Uirnad to ne«»-l|ne character# (tha standard Una dal In iter) and 
both a carriage ratura am a Use fa ad ara achoad to tha tarni- 
aal. If you pot lato tha uroof ooda. tha atty couaid ( 1 ) M m 
raacua you. 


Tab charactara ara u#ad fraaiy in UNIX source prograas. if your 
terminal doaa not have tha tab function, you can arranga to hav« 
tha* turnad Into a pa caa during output, and achoad aa spa caa dur- 
ing input. Tha syata* asaumaa that tab# ara aat every aight 
ao lumas . Again, tha atty c o aaim (l) Mill aat or raaat this 
mod#. Also, thara la a flla which. If prlntad on TTY I? or Tar- 
■INat 300 tacoinaia, will aat tha tab atop# corractiy 
(tabs(VII)). 

•action dc(lV) diacuaaaa typawrltar I/O aora fully. Saction 
fcl(lV) diacuaaaa tha consol a typauritar. 

Mm is inn b ul&uif; im Hull 

Whan you haua auccaaafully loq^jad Into UNIX , a propria called (tie 
•he 1 1 la listening to youi taralnal. Tha Shall ceads typad-m 
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Umi, splits thts up into s CflMMi ns— sad srsu—nts. and sms- 
cutss ths coMisl. A c o— i s ad is slaply Am s— cuts bis pro?rs©. 

Tbs shell looks first is your eurrs— dirsctory (s— —at ©ac- 
tion) for s progrso with tbs iftssi aas«, sad if so ns is tbsrs 9 
tbs a ia s systso dirsctory. tbs to is osthiof spscisi shout 
systsw-provld— cosss ads swcspt that llsy sis hspt is s dirsctory 
Sara ths Shsli css fiad th— . 

Ths cos— ad as— is si— ys ths first word — sa input ii—} it 
— d its stfu— sis sis sspsrst— fr— o— saothsr hy spscss# 

whan s proyrss tarsi— tss t t— Shsii wiii ordinarily rs«sla con- 
trol and typo s I* at you to I— tests thst it Is tssdy for 
saothsr con— ad • 

Ths Shall has —ay othsr capabllltlas, which srs dsscrlhsd in 
da tail is sacti— sh|I). 

Ths fur rant ^iractQPf 

UWII has s fils syst— arrant— la a hiararchy of director lss« 
whan ths systso adsiaiatrator fa— you a u— r ns—. ho also 
ersat— a dirsctory for you Is— I— rlly with ths as— as— so 
your u— r —I. Shoo you Uf la. say fils ns— you typo Is by 
dsf suit la this dirsctory# Sloes you srs ths ow— r of Ills 
dirsctory. you — — foil parol— lo— to ra— 9 writs, altar, or 
dsstroy Its c— toats# Parol— is— to ha— your will with othar 
dir— tori— a— fllos will hs— ho— yrs— or d— I— to you by 
t— I? — — rs. As s — ttsr of ob— rw— fact, fsw —IS u-rs pro- 
tact thslr fllos ffoy d— troctl— . 1st alo— poro— I. by othar 

MMfV* 

1 # cktm tha currant 4 lnct»n IM not th. ant of par. iaaloaa 
you Mar* antnrTl with at lo,la) waa cMltlll. 

mu iimi 

To rafaronca (Uaa not ta tha currant directory, you nuat uaa a 
path as—. 

ruil oath baa in with *7\ tha aaaa of tha root directory of 

tha whola (IU ayataa. Aftar tha alaah comoo ® •**/*! 

directory coot a Inina tha naat »uh-#iractoy |f°Uowa# ^a / j 

until finally tfca fll« — • »• loach*#. •'TTlISif . 

rafara to fllo f linn in dtractory I no | lo. lo ltao»t • 
aub-diractoty of uar , uor a pc la, a tfiractly fro. tho root 
dirsctory. 

II vour currant dlrnctory Ml aubdlractorlaa. tho P** 1 *. "j**** ot 
{* laa thara In ba,ln -ith tho ^ of tho auMlroctory 4 no P .a- 

I liiad /*). 

Without important. ©*ic©piion # © p©th ns— —y — u©— ©nywh©r© • 
f ll© I© rsqulr©d. 

M©nd© Mh|ch sodlfy ih© content© ot Ml©© ©r© cp( I ) , 

- I* - 


l©poi t 


— (I). ©nd roil), which r«©p©ctlv©ly copy, wv© (!.©• r©n©s©) •«! 
rs— fuss. To find out ths ststus ot fll©© or dir©ctorl©s v 
CO 1©<I) snd ©tstll). 8©# skdlr(l) for *©*1— dirsctorlssi 
c— lr(l) for dsstroy ing than. 

for s fullsr discussion of ths fils syst— » •©© —-71 -1 273-4 . It 
— y si so hs uss fu! to flsacs throuyh sactlon II of this — nu©I 9 
—I eh discuss— syst— calls, s— s if you don t ints— to dssi 
with ths syst— st ths ssssab ly-ls—usps Is— I. 


To sntsr ths tsst of s sourcs pros—* into s UM1X fil©, u©s 
—41). Tha thins principal Issfusyss In imii srs sssoabiy 
Isasusfs 4s— ss4ll)» fortrss 4s— fc4l)). •— C 4sss cell)). 
Aftsr ths proorsa tsst has bsss sat s rad through tha — Itor and 
—ittss on s fils, you can fl— ths fils to ths appropriate 
Uasusas procss— r ss ss stfun— t. Ths output of ths Isnfuag© 
srocs— or will hs Isft — s fils In ths currant dirsctory nsu— 

Ilf tbs output is prsclous. —a ©v to — It to • ••• 

— so— #) If you wrots Is ssssuhly Isnfusg©. you will 
Kohshlv — — — lo— ths profraa with library subrout I n©S| ass 
Cm. Thl oiMr two lawgtMfa procaoaora call tha loador nu- 
ntlcnlly. 


tha loadar au- 


whaa you ha«o finally ,ona through thin nntlrn procnan without 
dla,aoitlc.. tha ranultln, pro«ra. can h. run by 
StHw iL L to tho (hall la rnaponaa to tho I pcowpt. 


^|yla« l to Wat to the than ta reeponaa w 

an. Mil you ulll naad la db(l). ha a dabu99nr. db la 

^ ^.•s^jrassarsMsr.wjTKiK 

— d wlrt— lly u— less for fortrss. 


v—r orosr— s can rscsi— srs— its Uom th# co-Wftd lln * ** mt u 
MtsS — ds. for ©ssssbly pro«r— s. s©« 

sw— (II). 

Hll procs— 1— 

al—s t all text Is snt©r- thro-h th. -Itor. Th© —nd. — t 
tfttn uaad to writ, t.nt on n taiwinal am. cnt(I>. pr(I». 
tofflll. or nroff(I>. 

- — luoly duapa ASCII taut on tha tarwlnal. utth no 

Tha cat cowoand aiop y "V < |u(t| tha taut and sup- 
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GLOSSARY 


This glocaary covers major terms that have special meaning for the UNIX system. It excludes ordi- 
nary terms of an such u ASCII*, compiler*, address space', or 'byte*. It also excludes most terms 
peculiar to a single pen of UNIX. e.g. ‘diversion' (troff). 'enumeration* (C). or 'pattern space' 
(sad). 

buffer pool so reed aed vme operations may be 
me epoe eom o< eence oto Bia . 
chmfc a mode of terminal input in which every 
character aot a spectoi c h oroaer becomes available 
to a reed (2) open— as tooe u it is typed, 
instead of being boffem id up to a erw/tar or SOT 
choroaer. 

charecam 1. a uatt of store, usually I bits; a byta. 

2. a token of the ASCII coda, with octal value 

betweoa 0 aed 0177. 

chmacmr dmine a device upoo which a /7/e system 
[ll cannot he mourned, such as s terminal or the 
mil device. 

child yeonom see fork. 

dam to make an open file unavailable for input or 
output; convene of open. 

cemmaad I . an metructioa to the shell. usually to 
rua a pro g ram ( 1 1 as a child proem. 2. by eaten* 
sioa. any esecosokle /7/e. mpecully a utility pro* 

I fit same as shell scrips 

sn ASCII character with octal 

04)27 or 0177. which doea not print but may 
otherwise affect the behavior of s terminal; cf. spe° 
no/ choroaer 

ceomul tmmiaai the terminal asaoaated with a 
process from which the process may rec ei ve inter- 
rupt. fast, sad hangup agnate. cf. process group, 
eaated net raw 1 1 L said of aa input streom (21 it 
which tpodol choroaen are sane, 
caahli a paealier gondii token. saying, or remam* 
i returned by or p rmea i d to a proprem 1)1. 
a core image of a terminated process 
lived for debugging; a core file is created under the 
name ‘oare’ in the current directory of tht precam 
cere batffi a copy of aU the sepmms of a running 
or terminated program; the copy may exist ia main 
store, ia the rrntp area, or m a core /7/e. 
creme to open a file for writing, bringing it into 
existence u a p/a in file if neemsary. and discarding 
any data it may have contained previously; cf. 
unlink. 

cmeom dr c o rny, xmhtag dteectacy the directory 
from which relosivo poshmmes begin ; s current 
directory is associated with mch process. 
hmi a background proems, often perpetual, 
that performs s system-wide public function, e.g. 
colendor(\) tod cfon(l): the affectad spelling a aa 
ancient legacy. 

Um) s virtual circuit twitch for digital 


the default name of s freshly compiled oh feet 
/lie. pronouaort A-dot^ut*; historically a. out signs* 
Hed assembler output, 
aheehne pathaa— same u foil posknomn. 
a sipnol scheduled by the dock. 

I. a collactjoa of dau gathered from 
several files into ooo file. 1 ■pe n ally, suck a col- 
lection gathered by arO) for uac as a library. 
trfummi I. a suing made available to a process 
upoo tfxtnuJftf a file. 2. a suing ia a c om mand, 
which the shell will pans to the oo mm aad program 
as an argument ( 1 1. 

ASCII ffb same as test file. 

iniMtii persistent only during the invocation of 

a procedure, said of dau bdongmg to a process: 

automatic dau occupim the stock segment: cf. 

static. 

kuchgrouad running independently of a terminal, 
said of a process: co nv ent of / onground 
MU vernacular name for a prototype Teletype 5*20 

terminal: cf. jerp. 

Moch the basic unit of buffers * g ia the kernel . 
1024 or 409* bytes in the Ith edition. 

Mach device s device upon which a /Ue system ( 1 1 
can be mourned, typically a permanent storage dev- 
ice such as a upe or disk drive, so called b a n use 
dau transfers to the device oocar by blocks: cf. 
chorocter device. 

baas to sun the op e rating ty 
because the kernel mam boemuap 
secondary score into aa empty machine 
(31 or proce s s persmta earn ek 

the first Mack of a fUo it 

r maned for a < 

1. an oaamf4 



key 

in a break causae a 
mm thereafter it is laierpretad as 
2. a Canute su cement ia the C 

*. in troffU). a 

it ne 


i. s suging area for inp e t -ou t pu t whore 
arbitrary-length trsnaachona are oo l Met ed iota eon* 
vement units for system operations; the file system 
(3) uses buffers, as dam stdio. 2. to use buffers. 
b d fa pad s regsoa of store available to the file 
system (3) for holding blocks: ?M bat raw (21 
mput-ouiput for block devices gam through the 
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INTR0(9) 


INTR0(9) 


NAME 

intro - introduction to 5620*reiited software 
DESCRIPTION 

Section 9 of this manual lists software for running or supporting Teletype DMD-5620 terminals, the 
current implementation of the ‘jerq’ graphics terminals. Subsections 9. 1-9.7 mirror the purposes of 
the preceding sections 1*7, with 9.1 being commands. 9.6 being games, etc. 

Few commands deal with a 5620 in native mode. 32ld( 9.1) loads programs into the terminal and 
mux (9.1) starts the characteristic ‘layer' or window system. Almost all other commands in section 
9 either run on Unix or within mux layers. 

A Isyer is technically a virtual terminal, but is almost indistinguishable in software from a real ter- 
minal: in particular, the interface described in ityld(A) applies to layers, except for the additional 
editing capabilities discussed in mux (9.1). 

The commands in sea ions 9.1 and 9.6 run on Unix, but moat implicitly call 32ld to download a 
program that replaces the default terminal process running in the layer. To Unia the interface is 
still that of a terminal; in particular Idnltiy it always connaaed to the layer. The default mux tar- 
minal program implements the teletype function itself. When a program is down-loaded a teletype 
line discipline is pushed on the stream (sea stream (A) and tty Id (A)). Some commends may simply 
emulate other terminals by down-loading a terminal program (see femt(9.|); others, such as the 
text editor tarn (9.1), are really two programs - one on Unix and one in the layer - commumcat- 
ing using standard input/output on Unix and aendchart )/rcrcher( ) in the terminal; see 
request (9.2). 


There is an identity between bitmaps and layers in the graphics software. Graphic objects are bit* 
mape. The primitives that operate on layers are aliased to the bitmap primitives, and the data struc* 
turea are isomorphic. When running under mux. a programmer need not consider layers as graphi- 
cal object! at all; the operating system checks the arguments to the graphics primitives and 
dispatches the appropriate operator depending on the type of the argument. Except in stand-alone 
software, layers are an invisible implementation detail. 

FILES 

/uar/ jerq/bin jerq -related Unix ob j a « programs 

/usr/ jerq/abia terminal programs, usually down-loaded automatically by programs in 
/tur/jqrq/bla 

SEE ALSO 

32ld( 9.1), entx (9.1). srramnM). ft (A) 


Page l 


Ninth Edition 


September 22. 1986 
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Combined Tables of Contents 


The following table lists every manual page ever printed, with the editions it appeared in marked +. 
A number instead of a + mark indicates that the page appeared in a different chapter of that edi- 
tion. An appended name in brackets [ ] means that a manual page was later superseded or sub- 
sumed by the named page. 

Research software that was not included in distribution tapes was generally omitted from the v6 and 
v7 manuals. With v7 an addendum about unexported software was printed for local use; items from 
it are flagged L. 

Thus one can infer from the table that apl existed from v5 through v7, but was never distributed. 
In vS it lived in chapter 6, “User maintained commands.” It disappeared with v8, a casualty of the 
conversion from PDP-1 Is to VAXes. 

Trivial name changes are quietly ignored, e.g. a change from eons (4) in v8 to console (4) in v9 and 
from file system (V) in vl-v3 to/r(V) in v4-6 to filsys(S) in v7-v9. The short descriptions also 
changed from time to time; those given here are from v7 or else from the edition where the page 
first appeared. 

1. Commands 

Except for games, “user maintained commands” from chapter 6 of vl-v6 are included here with 
chapter 1, where they resided in later editions. 


Edition Title 

123456789 

Purpose 

♦ + + intro 

introduction to commands 

. + +* 

place label [foto] 

+ + — 

redo previous shell command 

. +8 acct 

get connect-time accounting 

+ . + adb 

debugger 

4- . altran 

language for algebraie computation [langsi 

. 6 . L . . apl 

APL interpreter 

++»pp*y 

apply a command to a set of arguments 

+ + apwnd 

send troff output to apt-5 

+ + + + + + + + + ar 

archive and library maintainer 


convert archives to new format 


assembler 

+ . m 

interpret ASA control characters 

+ + asdi 

interpret ASCII characters 

++ + at 

execute commands at a later time 

+ + + awk 

pattern scanning and processing language 

-6 6 6... a zd 

obtain satellite predictions 

♦ + b 

compile b program 

+ backup 

backup and recover files 

+ + + + 6 ++ . . bas 

basic (hoc) 

♦ + + basename 

strip filename affixes 

6 6 * . basic 

. DEC supplied basic (lanpl 

+ -*■ + + be 

arbitrary-precision arithmetic language 

L . . bs 

a compiler/interpreter for modest-sized programs 

+ + bundle 

collect files for distribution 
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Edition Title 

123456789 

4 . byteyears 

66 . 6 6 6 4 4 7 cal 

4 4 4 calendar 

L . . call 

4 4 can 

444444444 cat 
... +6 ... . catsim 

4- + 4cb 

4 4 cbt 

. 44444444CC 

4 . . cd 

. . 4 + 4 4 . . . cdb 

L 4- . cflow 

444444 . . . chdir 
444444444 chmod 
4 + 44 + 8+88 chown 

4cin 

+• cite 

-+ . clear 

-4-4-4-4-4-4-4-44- cmp 

.... 6 6 4 .. col 

-4 -4 column 

... -4 -4 -4 -4 -4 comm 

4 . . con 

4-4coreid 

4444 + 4 + 44 C p 

L 4 4 cpio 

6 4 + + + L . . cref 
. . 4 . . -4-4 6 crypt 

4-4Ct 

4 4 4 CU 

4 -4 CUt 

4-4cynux 

4 -4 d202 

6 6 das 

44 + 444444 date 
4-44444. . . db 

+ 

444444444 <$C 

44dooa 

.... 44444dd 

444daroff 

4448 8 8 444df 
. . . . 4 4 4 4 4 diff 

44 . dim 

4 4dired 

6 6 8 dli 

4 4docgen 

4 4doctypc 

6 6 dpt 

L . . draw 

.4 ds 


Purpose 

time-space product for file residency 
pnnt calendar 
reminder service 
ring a telephone 

interface to Cannon laser-printer spooler 
catenate and print 
phototypesetter simulator 
C program beautifier 
btree utilities 
C compiler 

change working directory [sh] 

C debugger [adb] 
generate C flow graph 
change working directory [cd] 
change mode 
change owner or group 
C interpreter 

process citations in a document 
clear terminal screen 
compare two files 
filter reverse line feeds [column] 
column alignment 

select or reject lines common to two sorted files 
connect to another UNIX [dcon] 
identify source of a core image 
copy file 

copy file archives in and out 
cross-reference table 
encode/decode 

call terminal (and start a session) 
call Unix 

rearrange columns of text 

C syntax checker 

pbotocypesetter filters 

disassembler [adb] 

print and set the date 

symbolic debugger [adb] 

write binary paper tape [dump] 

desk calculator 

remote login and execution 

convert and copy a file 

remove nroff, trofF, tbi and eqn constructs 

disk free 

differential file comparator 
3-way differential file comparison 
directory editor 
load DEC binary paper tapes 
generate a document from a script 
guess command line for formatting a document 
. read DEC ASCII paper tapes 
edit a circuit diagram 
verify directory hierarchy 
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* + ♦ + + +. . . dsw 

+ dtf 

+ + +-4--*-4-4. + 4-dU 
. + + + + •*■+• + + echo 
+*+ , *++ , + , "++ , + , +*ed 

+ . efl 

. . . . + + + + + eqn 
.+++++... exit 

+ + + expr 

+ + + f77 

. . + + 66 + + + factor 
.+++++. . . fc 
. +-+-+- + 6 ... fed 

L . . fget 

. . .+.++++ file 

+ + find 

. . . . + + + + + find 

+ fmt 

+ for 

+ + + + + 6L. . form 

. . + forml 

L . . fsend 

L . . gcat 

+ + getuid 

L . gex 

+ gone, fishing 

.+++++. . . goto 
... 6 ... . graf 

+ + grap 

6 + + + graph 

L . . greek 

. . . ++++++ grep 
.... 6 6 ... gsi 

+ + hang 

+ + hoc 

L . . huff 

+ hup 

..+66.... hyphen 
6 . L . . ibm 

+ . iooot 

+ + ideal 

+ + idifT 

.+ + + + +... if 

L . . iget 

+ + . iostat 

L . . isend 


Purpose 


delete files interactively [rml 
format DECtape 
summarize disk usage 
echo arguments 
text editor 

extended Fortran language preprocessor . ^ 

typeset mathematics 

end command sequence tshl 

evaluate arguments as an expression 

Fortran 77 compiler 

factor a number, generate large primes 

compile Fortran program IF77J 

form-letter editor [form] 

retrieve files from HIS 6000 

determine file type 

find file with a given name 

find files 

ultra-simple text formatter 
compile fortran program [fc] 
generate form letter 
generate form letters 
send files to HIS 6000 

send phototypesetter output to HIS 6000 (apsend] 
get user identity 

graphics exerciser for Tektronix 4014 
automatic reply to mail 
command transfer (shl 
draw graph on GSI terminal 
pic preprocessor for drawing graphs 
draw a graph 

interpret extended character set 
search a file for a pattern 
interpret funny characters on GSI terminal 
start a process in stopped state 
interactive floating point language 
Huffman code file compression [pack] 

hang up typewrite 

find hyphenated words 
submit off-line job to HO IBM 370 
Icon language translator and compiler 
troff preprocessor for drawing pictures 
interactive file comparison 
conditional command (shl 
get files from Holmdel IBM 370 
report I/O statistics (load) 
send files to Holmdel IBM 370 


+ + + join 

. . 8 + + + + + + kill 

L + + lab 

+langs 

+ . last 

+ Ibppt 


relational database operator 
* terminate a process with extreme prejudice 
label maker 

altran. basic. ... languages 
report recent logins [who] 
read binary paper tape [restor] 
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4 + Icomp 

+ + 4 + + + + 4 + |(i 

L . . Ide 

+ 4 + learn 

+ 44lex 

44 + lint 

4 . lisp 

4444 + + 444ln 

4 load 

. 4+++++S8 login 

+>4- look 

4 . . lookall 

4 - . + lorder 

. . . . 4 . 4 4 4 Ipr 

+ + + + + 444 + IS 

4 4 + m4 

.+46 66. . . m6 

4 4 Mail 

444444444 mail 

4 44 make 

. 44 44 + + 44 man 

4 . matlab 

... 4 merge 

+ + + + + * + + + mC 3g 

4mk 

444444 + 44 mkdir 

4mkpkg 

4 monk 

.44 mt 

4++++++++mv 
...44... neqn 

4 4 newer 

4 44 4newgrp 

4 4newi 

L . . nfs 

. . . 4 4 4 4 4 4 nice 
444444444 niB 
. . . 4 44 . . . nohup 
.... 6 .... npr 
. 44444 . . . nroff 

L 46 number 

4\4 4 4 4 4 4 4 4 od 
. 444 + + L . . opr 
.4 + 6 ov 

4+p 

4 + pack 

4 . paper 

4 4 pascal 

. . 4 4 4 4 4 4 4 paSSWd 
4 PC 

. . .444. . . pfe 
4 4 pic 


Purpose 

line-by-line profiler 
loader 

logic design equation language 
computer aided instruction about UNIX 
generator of lexical analysis programs 
a C program verifier 
lisp interpreter and compiler [langsl 
make a link 

load and input-output statistics 
sign on 

find lines in a sorted list 

look through all text files on UNIX 

find ordering relation for an object library 

line printer spooler 

list contents of directory 

macro processor 

macroprocessor (m4) 

send and receive mail 

send or receive mail among users 

maintain program groups 

print sections of this manual 

interactive matrix desk calculator [lanp] 

merge several files (sort] 

permit or deny messages 

maintain (make) related files 

make a directory 

make and install packages 

typeset documents and letters 

save/restore files on magtape [tar] 

move or rename files and directories 

typeset mathematics on a terminal (eqn] 

test file modification dates 

log in to a new group 

print news items 

communicate with Spider File System 
run a command at low priority 
print name list 

run a command at low priority [nice] 
print fils on Spider line- printer 
format text for printing (troff) 
convert Arabic numerals to English 
octal dump 
print file off-line 
page overlay file print 
paginate 

compress and expand files 

list input on HP2621P printer 

language interpreter 

install new password or user 

pascal language compiler 

print floating exception 

troff preprocessor for drawing pictures 
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+ . pick 

L . . place 

. ... 6 ... . plog 

. . . > 6 6 +• +- + plot 

+■ . post 

«► + + + * + + + + pr 

+■ prefer 

+ • • prep 

6 . . . prime* 

.... -♦--♦“‘♦--♦•-♦-prof 

L . . prom 

. . 4- + proof 

. . 8 + + + + + + ps 

6666 . 4- + + ptx 

4- . . pubindex 

4- + push 

.... + + + +-4-pwd 

♦ • P*P 

4- + random 

+ . raniib 

4- 4- + . ratfor 

+ + + refer 

+♦ + + rev 

+ 4- + + 4* . . . . rew 

+■ rkd 

4- rkf 

+• rkl 

4-4- + + + + + + 4-rm 
4- 4- + + + . . . rmdir 

4- + 4- + 4- 4- 4- . . roff 
+ + ropy 

4-rscan 

+ sdate 

4-4-sdb 

L . . sdifT 

4-seal 

4-4-4-sed 

4-sendcover 

++seq 

♦ ♦server 

... 6 .... sft 
♦♦♦♦♦♦♦ ♦ ♦ sh 

♦ ♦♦♦ . . . Shift 

>4- ship 

. . ♦ ♦♦♦ ♦ ♦♦ size 
. 6 6 6 L 7 7 sky 

. . . ♦♦♦♦♦♦ sleep 

4- + 6 6 L ♦ . sno 

♦ ♦ SIMOOM 

6 ♦ 4- + + + + 4- + sort 

. 4- 6 6 L . . speak 

. . . . +44 + + spell 


Purpose 

pick arguments [apply] 

design physical layout of a circuit 

make a graph on the gsi terminal 

graphics filter 

send mail to users by name 

print file 

maintain and use bibliographic references 
prepare text for statistical processing 
print all primes larger than somewhat (factor] 
display profile data 

read and write proms through the PROLOG promwriter 
compare text files (diff) 
process status 
permuted index 

make inverted bibliographic index [refer] 
datakit remote file copy 
working directory name 

pascal printer, profiler, and cross-reference lister 
sample lines from a file or provide random exit code 
convert archives to random libraries [arl 
Ratfor compiler [lanp] 

find and insert literature references in documents 

reverse lines of a file 

rewind DECtape 

dump disk to tape 

format RK disk 

load disk from tape 

remove (unlink) files 

remove (delete) directory [rml 

format text 

remote file copy for arpa internet 

scan pages on ricoh scanner and display on 5620 

adjust date and time (date) 

symbolic debugger 

side-by-tide difference program 

mailable data file 

stream editor 

send cover sheet to the library 
print sequences of numbers 
run anonymous command on another machine 
structured file scanner 
command language 
adjust shell arguments (shl 
automatic software distribution 
size of an object file 
obtain ephemerides 
suspend execution for an interval 
compile Snoboi programs (lanp) 
snoboi with syntactic sugar 
> sort or merge files 
send words to voice synthesizer 
find spelling errors 
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4- . spitbol 

. . 6 6 6 4- . . spline 
+ + + + + + 4- split 

+ + + stat 

+ + + + 4- 4- + + -h strip 

++ . struct 

. + + + + 4-4-4- + stty 
+ + + + + . + + + sum 

+ + + tabs 

+ + + tail 

+ + + tap 

+ + tape 

-♦--♦•-♦-tar 

6 + + + tbl 

+ . . tc 

. . . .+ + + + + tee 

L . . tekstare 

-f . telnet 

+ + + test 

+ tex 

. . -♦--♦•-♦--♦--♦•-♦--♦-time 

+• . tk 

6 4- 6 6 6 L . . tmg 

4- 4- -f touch 

. . . 4- 4- 4- 4- . . tp 

. . . 4- 4- 4- 4- 4- 4- tr 

4- 4- trace 

4- . track 

. . . 4- + + 4- 4- 4- troff 

4- 4- 4- true 

4- . tset 

4-4-4-tsort 

. 4- 4- 4- 4- . L . . tss 
4- + + + + + + + + tty 

4- 4- 4- 4- type 

. . 4- 4- 4* 4* L . . typo 

L . . ufs 

4- + ul 

4-4-4- Ufa 

. . + + + + + 4-4-uniq 

6 + 7 7 units 

4- . . . usort 

♦♦ + UUCP 

L . . uudiff 

4-4-UUJUt 

+ + + UUX 

L . . VC 

4-4-vi 

4- 4- view 2d 

4-4* vis 

4- . visi 

. . 4- vs 


Purpose 

Snobol language compiler [langs] 
interpolate smooth curve 
split a file into pieces 
get file status 

remove symbols and relocation bits 

structure Fortran programs 

set terminal options 

sum and count blocks in a file 

set terminal tabs 

deliver the last part of a file 

manipulate DECtape 

identify and manipulate magnetic tape 

tape archiver 

format tables for nroff or troff 
troff output interpreter 
pipe fitting 

convert tektronix picture to hard copy graphics [can] 

user interface to the telnet protocol 

condition command 

text formatting and typesetting 

time a command 

paginator for the Tektronix 4014 

compile tmgl program 

update date last modified of a file 

manipulate tape archive [tar] 

translate characters 

protocol compiler and analyzer 

selective remote file copy 

text formatting and typesetting 

provide truth values 

set terminal modes 

topological sort 

communicate with MH-TSS (GCOS3 
get terminal name 
print file on IBM 2741 
find typographic er r ors 
Spider Network Communication 
print underlines on screen terminals 
fine undefined symbols 
report repeated lines in a file 
conversion program 

sort and merge files, discarding duplicate lines [sort] 
unix to unix copy 

directory comparison between machines 
uucp status inquiry and job control 
unix to unix command execution 
verification of tests for C programs (lcompl 
screen oriented (visual) display editor based on ex 
movie of a function f(x«y,t) 

* show invisible characters 
mathematical spreadsheet 
generate voice synthesizer phonemes 
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. . . +• + 4- 4- . . wait 
f + f + + + f + + WC 

L . . wcheck 

+ 4 - 4-4- 4 - «- -*■ + + who 

L . . wrap 

4-4»4-4-4’4-+>4-4- write 
+>4* wwb 

4 + WWV 

L . . xref 

4* + . xsend 

■ 6 6 6 444 + yacc 

2. System calls 

Edition Title 

123456789 

.... + 4- 4- 4- 4- intro 

4- 4- 4- access 

+ + + acct 

4- 4- 4- alarm 

. . 4- . . . . 4- . bOOt 

4- 4» 4- 4- 4- 4- . . . break 

4-4-4- cemt 

4-4-4-4-4-4-4-4-4- chdir 
^4-4-4-4-4-4-4-4-chmod 

4-4-4»4*4»4>4**f-f chOWn 
4-4-4-4-4-4-4»4-4- ciOSC 
4-4-4-4-4-4»4»4-4- crett 
. . 4- 4- 4- 4- . . . CSW 

4- deprecated 

. . 4- 4- 4- 4- 4- 4- 4- dup 
^-4- 4- 4- 4- 4- 4- 4- exeC 
4- 4- 4- 4- 4- 4- 4- 4- 4- exit 
4-fmount 

4-4-4-4-4-4-4-4-4- fork 

• • * f|» 

+ + + + + ■*■. . . but 

getpd 

+♦. . f«tpid 

+ + + + + + +++ gttaid 
+• . gnwiit 


+ + + + + +. . . gtty 

• ♦ ho« 

4* 4- + ilgins 

. . . 4- 4* +> + . . indir 
4-4-4- intr 


4-4-4-ioCtl 

. 4- + + + + + + + kill 
♦ + + + + + + link 

4- . . lock 

4-4-4- tseek 

4-4-4- 4- mkdir 

. . . 4-4-4-4-4-4-mknod 


Purpose 

await completion of process [shl 
word count 

look for inconsistencies in a circuit description 
who is on the system 

generate control information for wiring a circuit board 
write to another user 
writers workbench 

print and set the date from accurate clock 
cross reference for C programs 
secret mail 

yet another compiler-compiler 


Purpose 

introduction to system calls and error numbers 

determine accessibility of file 

turn accounting on or off 

schedule signal after specified time 

reboot the system 

set program break [brk] 

catch EMT traps [signal] 

change default directory 

change mode of file 

change owner and group of a file 

close a file 

create a new file 

read the console switches 

system calls to be avoided 

duplicate an open file descriptor 

execute a file 

terminate p r o c ess 

mount or remove file system 

spawn new proce ss 

catch floating exception errors [signal] 

status of open file [stat] 

get group identification [getuid] 

get process identification [getuid] 

get user and group identity 

mount or remove non-standard file system [fmount] 

get typewrite mode [local] 

set low-priority status (nice) 

catch illegal instruction trap (signal) 

indirect system call (syscall) 

catch or inhib interrupts (signal] 

control device 

send signal to a p r o c ess 

link to a file 

lock a process in primary memory 
move read/write pointer 
create directory 

make a directory or a special file 
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44444444 . mount 

4 . . mpx 

. . + «*■ + 4 + 4 4 nice 
444444444 open 

4 4 . pause 

+ • • phy» 

. . 444444 . pipe 

4 . . pkon 

.... 4 44 4 4 profii 

444 . ptrace 

4 4 4 quit 

444444444 read 

444 rele 

4 4 4 4 4 4 . . . seek 

4 4 select 

...44 4- . . . setgid 
444444444 setuid 
. . . 4 4- 4 4 4 signal 

. 44444 ... sleep 

4 4 + smdate 

444444444 stat 
444444444 stime 
444 4 •►+ . . . stty 
. 44 4 4444 4sync 

4 4 syscall 

+ + tell 

444444444 time 
. . 4 + + + + 4 4 times 

4f -umask 

4 4 4 4 4 4. . . amount 
444444444 unlink 
444 mime 

444444444 wait 
4 4 4 4 4 4 4 4 4 Write 

3. Subroutines 

Edition Title 

123456719 

+ + 4intro 

++++abort 

. . . . 44. . aba 

. . 44, . . alloe 

4 4arith 

444asicrt 

. 44444 . . . atan 
444444444 atof 
444 . . 4 . . . atoi 

4 4 cbt 

4 4chrtab 

.44 compar 

.4 const 

7 L . . cr 


Purpose 

mount or remove file system (fmountl 

create and manipulate multiplexed files 

set program priority 

open for reading or writing 

stop until signal [alarm! 

allow a process to access physical addresses 

create an interprocess channel 

establish packet protocol 

execution time profile 

process trace (proc(4)] 

catch or inhibit quits [signal] 

read from file 

release processor 

move read or write pointer [lseek] 
synchronous I/O multiplexing 
set process group ID [setuid] 
set user and group ID 
catch or ignore signals . 
delay execution [alarm] 
set date modified of file [utime] 
get file status 
set time 

set mode of typewriter [ioctl] 

update super-block 

indirect system call 

find read or write pointer [seek] 

get date and time 

get process times 

set file creation mode mask 

dismount file system [mount] 

remove directory entry 

set file timet 

wait for process to terminate 
write on a file 


Purpose 

introduction to library functions 
generate IOT fault 

integer absolute value, sign function [arith] 

core allocator [malkx] 

integer arithmetic functions 

program verification 

arctangent [sin] 

convert ASCII to numbers 

convert ASCII to integer (atof] 

compressed B-tree subroutines 

simple character bitmaps 

string compare for sort 

floating point constants 

coroutine scheme 
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l 2 3 4 5 6 7 8 9 

. . + + + + ■♦■ + + crypt 
+ + + + + + ctime 

■+• + ■+* ctypc 

+ + curses 

+ dbm 

. . > ddsput 

+ + dialout 

+ + directory 

+ . dkmgr 

. . + + + + + + + ecvt 

-*- + + + end 

L + + erf 

+ + + + + + + + + exp 

+ + + fclose 

+ + + ferror 

+ fio 

.... + + + + ♦ floor 

+ . . . fmod 

+ + + fopen 

+++♦+♦. . . fptrap 

+ + + freed 

+ 4- + frexp 

♦ + + fseek 

+ + + ftoa 

. . + ftoo 

+ + ftw 

L + + galloc 

. . . . + + L + + gamma 

.++•+■ gerts 

. . . .++.++ geurg 
+ ^4**"^ + + + + + getc 
...+♦+... getchar 

+ + + getenv 

+ getfields 

* * getfsent 

+ + + getgrent 

+ 4- + getlogin 

+ + getopt 

+ + + getpass 

. . . ♦ ++♦. . getpw 

+ + + getpwent 

+++get» 

+ + getwd 

. . . + + ♦ . . . hmul 
. + + + ♦ . + + + hypot 
. . . + + 4- . . . ierror 

+ internet 

+ ipc 

-*• + 4- itoa 

+ + +j0 

+ + + 13tol 

...♦++... ldiv 


Purpose 

DES encryption 

convert date and time to ASCII 

character classification 

screen functions with 'optimal* cursor motion 

data base subroutines 

display characters on Picturephone 

place call on ACU 

directory operations 

establish data kit server 

output conversion 

last locations in program 

error function 

exponential, logarithm, power, square root 
close or flush a stream 
stream statu s inquiries 
fast buffered I/O 

absolute value, floor, ceiling functions 
floating modulus function [floor! 
open a stream 
floating-point simulator 
buffered binary input/output 
split into mantissa and exponent 
reposition a stream 
convert floating to ASCII (ecvt) 
convert floating to octal 
file tree walk 

storage allocation with garbage collection 

log gamma function 

communicate with GCOS 

get command arguments from Fortran 

get character or word from stream 

read character (getc) 

value for en v ir onme n t name 

break a string into fields 

get file system descriptor file entry 

get group file entry 

get login name 

get option letter from argv 

read a password 

get name from UID 

get password file entry 

get a string from a stream 

get current directory 

high-order product 

euclidean distance 

catch Fortran errors 

internet networking functions 

set up communications between unrelated processes 

convert integer to ASCII 

bessel functions 

convert between 3-byte integers and long integers 
long division 
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7 liba 


7 

. . . 1 1 ua 

. . . libb 

7 

. . . libf 

.... 4 - -4 

. loev 

-4-4 4- -4 -4 -4 

• log 


- 44 - 4 - malloc 


L + + map 

- 44 - memory 

-4 4- 4* 4- mesg 

- 4 * 44 - mktemp 

. . . . *4 + 4-4-4- monitor 

4 + + mp 

. . . 4 + + . . . nargs 

. -4 -4 -4 -4 -4 4- -4 -4 fllist 

. . . -4 -4 -4 -4 -4 -4 perror 

4- . . pkopen 

7 + + 4> plot 

+ + + popen 

*4 4* port 

. . 4444. . . pow 

*4 print 

. . . -4 -4 -4 -4 4- -4 printf 

- 44 - 4 - ptime 

- 44 -ptopen 

44444 + 444 pUtC 

. . . 444 . . . putchar 

-4 4- 4- puts 

. 4- 4- 4- 4- 4- 4- 4- 4- qsoit 
. . 4- 4- -4 4 - 4- 4- -4 rand 

4- . regex 

4- 4- regexp 

reset 

. -4 4- . . 7 L . . saiioc 

-4-4 4-scanf 

4* 4- 4- setbuf 

. . . 4- 4- 4- . . . setfll 

-4 + 4-setjmp 

-4 4- 4- -4 4* -4 + 4* 4- fill 

4- + + sinh 

+++sleep 

sqrt 

4- + + std»a 

-4 4* 4- string 

4- 4- 4- swab 

-4 4- -4 4- Switch 

4- 4- 4* system 

4-tCp 

L -4 4- tdkdial 

4-4-termcap 

-4 4-tolower 

. . -4 4- 4 - 4- 4- 4 - 4- ttyname 
4»udp 


Purpose 

standard assembly-language library 

standard B library 

standard Fortran library 

long output conversion [printf] 

logarithm base e [exp] 

main memory allocator 

map projections 

memory operations 

print string on typewriter [printf] 

make a unique file name 

prepare execution profile 

multiple precision integer arithmetic 

argument count 

get entries from name list 

system error messages 

packet driver simulator 

graphics interface 

initiate I/O to/from a process 

mathematical library for Fortran 

take powers of numbers [exp] 

print formatted output 

output formatters 

print time 

find and open a pseudo-terminal file 
put character or word on a stream 
write character [putc] 
put a string on a stream 
quicker sort 

random number generator 
regular expression handler [regexp] 
regular expression handler 
execute non-local goto [setjmpl 
string allocation and manipulation 
formatted input conversion 
assign buffering to a stream 
specify Fortran file name 
non-local goto 
trigonometric functions 
hyperbolic functions 
suspend execution for interval 
square root [exp] 

standard buffered input/output package 
string operations 
swap bytes 

transfer depending on value 
issue a shell command 
tep networking functions 
- open a datakit connection to a remote server 
terminal independent operation routines 
* force upper or lower case 
find name of a terminal 
udp networking functions 
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4-uname 

+ + + ungetc 

+ + varargs 

> + view2d 

. . . ++ . . . . Vt 


Purpose 

get password file entry 
push character back into input stream 
variable argument list 
movie of a function f(x,y,t) 
display (vtOl) interface 


4. Special files 

Terminology changed often in this section. In v3 mnemonic names were replaced by names of DEC 
devices, for example, tty became kl , ttyO became dc . and ppt became pc . The more recent names 
are used here. Lately the trend has reversed, with the appearance of drum and cons. 

Edition Title Purpose 

123456789 


+• + bufid 

. . .+ + + +. .cat 

4-connld 

4- -4 cons 

. . . *4 da 

4- + + ♦ + + . . . dc 
dh 

L + + dk 

. 4- 4- -4 -4 + -4 . . dn 
. 444 + 4. . . dp 

4- +• drum 

4» . . du 

4-4-fd 

-4 -4 . . hp 

-4 4- . . hS 

-4 -4 . . ht 

444 + 44. . . kl 

. 4 - . . 4- + L + . Ip 

44 + 4444 + . mem 

4-4-mesgld 

. -44»4-4-4-4-4-4*mt 

4- . -44-null 

*44-4-4--44* ... pC 

♦. • Pk 

+ 4-proc 



4-4-ra 

-44-4-4--4-4+. . if 
4-4-4-«44-> + +. rfc 
4- . 4-4--4+. . rp 

4- -4 stream 

4- -4 4- -4 -4 4- -4 . .tC 
. . . 4-4- . L . . tin 
. . . . 4-4-4- . -4tty 

4-4-ttyW 

4-. . vp 

. . . 4- 4- . L . . vs 


buffering line discipline 
phototypesetter interface 
connection line discipline 
console interface 
voice response unit 
remote typewriter 

DH-ll communications multiplexor 

Datakit interface 

DN-U ACU interface 

201 dataphone 

paging device 

DU-ll 201 data-pbone interface 
file descriptor file 

RH-11/RP04, RP05, RP06 moving-head disk 

RH11/RS03-RS04 fixed-head disk file 

RH-1 l/TU-16 magtape interface 

console typewriter Icons] 

line printer 

core memory 

message line discipline 

magtape interface 

data sink (mem] 

punched paper tape 

packet driver 

procam file system 

interprocess I/O junctor files 

DEC MSCP disks (RA60, RA80, RA81) 

RF1 1/RSl 1 fixed-head disk file 
RK-11/RK03 or RK03 disk 
RP-l 1/RP03 moving-head disk 
stream I/O control calls 
TC-11/TU56 DECupe 
Spider interface 

general terminal interface Ittyld] 
terminal processing 
Versa tec printer-plotter 
voice synthesizer interface 
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Edition Title Purpose 

123456789 

. . + + + . . . . vt storage-tube display 


5. File formats and conventions 


In vl-v5. section 5 was restricted to “File formats” 


Edition Title 

123456789 

♦ + + + + + + + + a.out 

+ + + acct 

+ + + + + + + + + ar 

+ backup 

> bppt 

4config 

+44+44+4+ core 

+ cpio 

«t- + -t-4-4* + + -f»-*-dir 

dump 

•♦•-♦•-♦-environ 

+ + + + + + + + + filsys 

4 + fstab 

-♦--♦•-♦•-♦•group 

. + ident 

-♦•-♦•map 

. . mpxio 

. . . . + + + 4- + mub 

+ + netnews 

+ . newsrc 

44+++++4+ passwd 

7 + + + plot 

+poiy 

speak.m 

4 + sub 

L . . tar 

4 4 termcap 

. 4444+4. . tp 

. . . . 4 + + + 4ttys 

♦♦types 

44 uids 

+ 4 4 + + + + + utmp 

4 + view2d 

4 + wboami 

K+ + +++ . . . wtmp 


Purpose 

assembler and link editor output 

execution accounting file 

archive (library) file format 

incremental backup file 

binary paper tape format 

system configuration files 

format of core image file 

format of cpio archive 

format of directories 

incremental dump format 

user environment 

format of file system volume 

static information about the file system 

group file 

GOOD idem cards 

digitized map formats 

multiplexed i/o 

mounted file system table 

USENET network news article, utility files 

information file for readnews 

password file 

graphics interface 

poiyhedra database format 

voice synthesizer vocabulary 

symbol table types 

format of tar archive 

terminal capability database 

DEC/mag tape formats 

terminal initialization data 

primitive system types 

map names to user ID’s 

login records 

movie of a function f(x,y,t) 
computer name 
accounting files (utmp] 


6, Games 

In vl through v6 chapter 6 was called “User maintained maintained programs.” Only the games 
from those editions are listed here; other pages from those chapters 6 are listed with chapter l or 
chapter 7. 

Edition Title Purpose 

123456789 

L 4 4 adventure dungeon-exploration game 

4 4 + arithmetic provide drill in number facts 

4 4* ate air traffic controller 



Edition Title 

123456789 

Purpose 

+ + + backgammon the game 

+ + + banner 

make long posters 

l + + *bcd 

convert to antique media 

+ + + + + . bj 

the game of black jack 

-*- + boggle 

word games 

+ abridge 

card game 

+ beards 

card games 

+ . . checkers 

game 

+ . ■ + + + + . . chess 

the game of chess 

++ . ching 

the book of changes and other cookies 

■ + + + . . . cubic 

three dimensional tic*tac*toe 


psychiatric consultation 


memo writer 

+ + fortune 

cookies 

+ . . . king 

the game of king 

. . .++.+. . maze 

generate a maze problem 

+ + . + + + + . . moo 

guessing game 

L . . morse 

convert letters to morse code 

1 +netnews 

sen dor receive news article 

L . . psych 

pattern generators 

+ + + + quiz 

test your knowledge 

+ . . reversi 

a game of dramatic reversals 

+ + snake 

display chase game 

L + + trek 

war games 

+ + . + + . . ttt 

tic*tac*toe 

+ . . words 

word games [boggle] 

♦ + worms 

silly demos 

. . . . + + + . . wump 

the game of hunt*the-wumpus 


7. Data baste and language couveutious 

Like chapter 6, chapter 7 has been a catch-all, with various names over the years: 

vl-vS Miscellaneous 

v6 User maintained subroutines 

v7 Conventions 

v8-9 Dau bases and language conventions 

Edition Title Purpose 

1 23456789 


+ + apotws 

+++++3 ♦ ♦♦asdi 
+ . candest 

L . . cdl 

. v . ++dkt 

+ + + eqnchar 

+ + font 

. . ♦ ♦ + 5 + . - greek 

+ . . hier 

♦ + kbd 

elates 

+ + library 

+ + login 

+ + mail 


present ap wire stories 
map of ASCII character set 
canon laser printers [can(l)l 
circuit description language 
look up words in English dictionaries 
special character definitions for eqa 
typesetter fonts 

graphics for extended HdY-37 type-boa 
file system hierarchy 
map of HdY 37 keyboard 
tex macro packages and bibliographies 
• bell labs library service 

logging on and logging off the system [how to get started] 
addreu conventions and rewrite rules 



Edition Title 

123456789 

4 - 4- 4 - man 

L ♦ + map 

Ambits 

4 - 4 -mcs 

4--K4--hms 

4-netnews 

+ papers 

+ poty 

I +■ postnews 

I 4-readnews 

4- scat 

+ submit 

+■ suftab 

4-4-4- 4-4- 5 . . . tabs 

4- 4- tel 

4- . telno 

4- 4- . term 

... 4- 4- ... . tmheader 

4- 4- town 

4-4-troff 

. . 4- 4- 4- . L . . vsp 

4- 4- weather 


Purpose 

macros to typeset manual 

draw maps on various projections 

macros for typesetting bitmaps 

macros for formatting cover sheets 

macros for formatting manuscripts 

recent articles, utility files 

browse database of locally authored papers 

database of poiyhedra 

submit netnews articles 

read news articles 

sky catalog 

install document in database 
roffs suffix table 

set tab stops on typewriter [tabs( I) 1 
local and private telephone books 
retrieve from bell labs phone book [tel] 
conventional names 
TM cover sheet 
gazetteer of US places 
addenda to troff manual 
voice synthesizer phonemes 
conditions and forecast by town 


8. Maintenance commands and procedures 

Pages from chapter 1 of vl, v2, and v7 that appeared in chapter 8 of other editions are included 
here. In vl and v2 there was no chapter 8 and in v7 many system maintenance commands were 
placed in chapter l, with the identification “IM”. 

Chapter 8 is the most turbulent part of the manual: maintenance procedures, being known only to a 
few, and often being embedded in just one or two shell scripts may be more lightly changed than 
mainstream facilities. Moreover, much of chapter 8 is concerned with hidden procedures that are 
usually invoked automatically. 

It has alway been problematic just how much to say about such changeable things that so few peo- 
ple need to know about. Maintenance programs may remain “unofficial” for years. For example, 
one or another version of findo. for scouring trash out of full file systems, had existed since the ear- 
liest days, yet it was not documented until v8. 

Edition Title Purpose 

123456789 


>4-11 pdpll support 

1 7 4-4-4-. . . . 20boot rebooot 11/20 system 

. . 4- + 1 4- 4-ac login accounting 

4-arff read RTll files 

7 as2 assembler's pass 2 

4- 4- asd automatic software distribution 

7 ba B assembler 

4- backup backup administration 

7 be , B compiler 

7 bilib B interpreter 

7 7 4-4-4-4-4-. . boot .sunup procedures [reboot] 

7 bnl.bn2 B sun and finish 

.6 chash prepare symbol uble 

l l 4 - 4 - 4 -. . . . check check consistency of file system [icheck] 
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Edition Title Purpose 

123456789 

+ . . . chgrp change group [chownj 

. . * chk check all file systems 

. . 1 + + + 1 ♦ ♦ clri clear i-node 

♦ + cpp C language preproc es sor 

+ + crash what to do when the system crashes 

+ + + + cron clock daemon 

. . + . . + l . . dcheck file system directory consistency check [icheck] 

+ + dmesg system diagnostic messages 

. I 7 7 + + L . dpd dauphone daemons 

. . . . + 1 . . dump incremental file system dump 

1 . . dumpdir print the names of files on a dump tape 

7 fl.an.f4 Fortran compiler passes 

L . . fget.demon fget daemons 

+ + finddev find process using a device 

+ + findo find objectionable files 

4-4- fsck file system consistency check and interactive repair 

. 7 7 7 + + + + + getty set typewriter mode 


7 7 7 7 r+. . . glob argument expander 

+ l + + icheck file system storage consistency check 

7777+++++ init process control initialization 

. . . + ino get the i*number of a file 

. I + istat file status by i-number 


+ ldpcs load correct microcode 

. . . . + + L+-Hpd line printer daemoo 

+ + + mtkekey generate encryption key 

+ mgrproc service remote computing requests 

1 . . mkconf generate configuration table* (config] 

I + I + + mkfs construct a file system 

...+ + + 1 + + mknod build special file 

I I + + + -M ++• mount mount and dismount file system 

7 7 7 7 +■ . . . msb mini Shell 

nc beck generate names from i-numben [icheck] 

+ + netfs network file system 

+ +• neutst show network status for ARPA internet 

+ -t-oops process statu* 

I + + psut print system fsets 

1 ++quot summariae file system ownership 

-f-f rmrept replace bed Mocks on MSCP drive 

+ ♦ re boat script 

++ reboot bootstrapping procedures 

. . I + + . . . . reloc relocate object film 

,, ++nake alter priority of running process by changing nice 

. ++I . . restor incremental file system restore 

+ . rmdir unlink directory 

. . . . + + 1 + + sa system accounting 

. I +• saiv repair damaged file system 

+ + savecore save a core dump of the operating system 

+ + showq . sum of stream I/O system 

♦ smash rewrita bad disk sectors 

t l + +■+•♦ l ++su - substituts user id temporarily 

+ + swapon specify peging/swapping device 

. . . + + +1 +sync update the super block 
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Edition Title 

123456789 

1 1 + tm 

1 l + + + + . . . umount 

-n-upas 

. . +■ + + 4- + + update 

*n-uucheck 

4-4- uucico 

L + + uudean 

♦ . uusched 

+ 4»uuxqt 

4- + vmstat 

4-1 4-4- wail 

+ . xstr 


Purpose 

get time information 

dismount removable file system [mount] 

address driven mailer 

periodically update the super block 

check uucp directories and permissions file 

file transport program for the uucp system 

uucp spool directory cleanup 

uucp file transport scheduler [uucico] 

create remote command requests 

report virtual memory statistics 

write to all users 

preprocessor for sharing strinp in C programs 


9. Teletype 5620-related software 

Edition Title Purpose 

123456789 


4- + intro 

9.1 Commands 

4- + 321d 

+ + 3cc 

4- 4- blitbit 

4- brush 

4* 4* cip 

4-4- face 

4- flicks 

4-getfont 

+ 4- graphdraw 

4- 4- icon 

*+jf 

4- . jim 



4- 4- lens 

4-4-mup 

4* + mux 

> + paint 

+ + ped 

+ + P* 

+ + pico 

+ + proof 

4-pvmoa 

4-reader 

. s 4- + rebecca 

4- 4- ruler 

4»sam 

4- 4- term 

4 - 4 -thinkblt 

4-4-vismon 

4-4- windows 


introduction to jerq-related software 

bootstrap loader for the 5620 
MAC-32 compiler for the 5620 
make hard copy image 
painting program 
picture drawing program 
show faces on a jerq 
movie graphics for 5620 
replace terminal's default font 
edit (combinatoric) graph 
icon editor 
font editor 
text editor [saml 

jerq execution and stdio interpreter 
bitmap magnifier 

convert gray-scale images into icons 
layer multiplexor for the jerq 
draw pictures in a layer 
picture editor 
pr o ce a inspector 
graphics editor 

troff output interpreter for jerq 

gray-scale picture preview window for 5620 

examine typeset documents 

graphics touch-up editor 

measure things on the screen 

screen editor with structural regular expressions 

nonstandard mux terminals 

print on ThinkJet 

system statistics and mail notification 
create and initialize windows 


9 2 System calls 

The shortness of this subchapter and the next belies the comprehensiveness of the mux operating 
system. Descriptions were combined to save pages: the four pages of 9.2 document some three 
dozen system calls. 
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Edition Title Purpose 

123456789 


-*- + button 

+■ + newlayer 

+ -♦- newproc 

^^request 

9 3 Subroutines 

'♦-•♦-add 

'♦-'♦-alloc 

+♦ bitblt 

-♦-'♦-circle 

+ -t-cos 

-♦- -♦- menuhit 

'♦-'♦'String 

> thinkdient 

9.4 Devices 


mouse control 
layer control and graphics 
jerq process control 
jerq I/O requests 

arithmetic on points and rectangles 

allocate memory 

basic jerq graphics functions 

circle drawing functions for jerq 

integer math functions 

present user with menu and get selection 

jerq text and font operations 

ThinkJet routines 


++ jioctl jerq ioctl requests 

+ + mouse jerq mouse interface 

9.5 File formats and conventions 

+ + bitfile format of bitmap file 

+ + faced network face server 

+ ♦ font jerq font layouts 

+ movies graphics movie file formats 

♦ + pads user interface package 

+ + types basic jerq graphics data types 

9.6 Games 


♦♦ crabs 

-♦--♦-demo 

-Kgebeca 

-t-menudrop 

-♦--♦-pen 

+pengo 

+ -*- twid 

9.7 Data bases 
+ + biitmap 


graphical marine adventure game 
graphic demonstration and games 
get back at corporate america 
leave a menu lying around 
doodle anywhere on the screen 
squash the sno-bees 
dabble in oils 

map plots and path finding on a jerq 
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